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Introduction 


This manual briefly describes the new features included in the SunOS™ 4.0.3 
release. 

SunOS 4.0.3 is a lull SunOS operating system release, and is fully compatible 
with SunOS 4.0 and 4.0.1. Integrated into this new SunOS release is support for 
many new hardware devices and some software features. Included also are 
descriptions of bugs fixed since the release of SunOS 4.0. 

SunOS 4.0.3 supports the Sun-2, Sun-3, Sun-4, and SPARCsystem 300 work¬ 
stations and servers. While the Sun-3 family now includes the Sun-3x kernel 
architecture group (see Chapter 5 in this manual), differentiating the Sun-3x from 
the Sun-3 is necessary only when discussing kernel issues. (Please note that this 
is the final SunOS release to support Sun-2.) 

Note that two different sets of tapes exist for SunOS 4.0.3: one supports full 
installs only and one supports upgrades only. Please make sure you are using the 
correct tape set for your installation. 


1.1. New Release Features This section highlights some of the new features in SunOS 4.0.3. 


New Sun Systems SunOS 4.0.3 supports several new Sun systems. 

□ Sun 3/400 series and Sun-3/80 systems. Motorola 68030-based additions to 
the Sun-3 family that are summarized in Table 1-1. 
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Table 1-1 New 68030-Based Systems (sun3x Architecture) in SunOS 4.0.3 


SYSTEM 

DESCRIPTION 

Sun-3/80 

A desktop system based on the 20-MHz Motorola pro¬ 
cessor. Options include integrated SCSI hard disk and 
3-1/2" floppy-disk drive. 

Sun-3/470 & Sun-3/480 

A deskside workstation (-3/470) and server (-3/480) 
based on the 33-MHz Motorola processor. Up to 1.3 
gigabytes of SCSI disk storage. Multiple SMD drives 
(up to 16 for the Sun-3/480 server). 60-megabyte or 
150-megabyte 1/4" tape drive. 


Note: Existing 68020-based Sun-3 systems (sun3 architecture) use the Sun 
MMU (Memory Management Unit), while the new 68030-based systems 
(sun3x architecture) have an on-chip MMU. The sun3x kernel was 
modified to support this difference, with ramifications that are discussed in 
detail in “Post-installation Issues,” later in this document. 

There are no differences at the user-application level. Sun-3 user applica¬ 
tions run without change on any Sun-31400 series or Sun-3/80 system. 

□ SPARCstation 330 is a member of the new SPARCsystem 300 family of 
high-performance systems. Features include multiple VME slots for 
memory expansion, up to 1.2 gigabytes of SCSI disk storage, and a 150- 
megabyte 1/4" tape drive. 


Supported Media for the 150- The 150-megabyte 1/4" tape drive can read from or write to the 3M-DC6150 
Megabyte Tape Drive (formerly the 3M-DC600XTD) tape cartridge. Sun Part Number 370-1203-01, 

and read from tapes that were written on a 60-megabyte drive, such as the 3M- 
DC300XL/P tape cartridge or the DEI Series II Silver tape cartridge, Sun Part 
Number 370-0543. 


Sun Microsystems supports only the use of the proper tape for the 
specified tape drives. The use of any other tape cartridges is not sup' 
ported. 


If you know the device name of your tape drive (for example, /dev/r st 8), you 
can load a tape and use the mt command to verify the drive capacity as follows: 



Revision A of 7 July 1989, Part. No. 800-3815-11 










Chapter 1 — Introduction 5 



# mt -f /dev /device-name status 


Archive QIC-150 tape drive: 

sense key(Ox)— no sense residual” 0 retries” 0 
file no= 0 block no= 0 

V_____ J 

You will see a message like the one shown above if you have a 150-megabyte 
drive. 

Note: You cannot read 150-megabyte tapes on a 60-megabyte drive, nor can 
you write 60-megabyte tapes on a 150-megabyte drive. 


New Hardware 



In addition to the new system products (see the preceding section), new hardware 

in SunOS Release 4.0.3 includes: 

□ The FPU2 floating-point hardware unit for selected Sun-4 systems and the 
FPA+, a high-performance floating-point accelerator for the Sun-3/470 and 
Sun-3/480. 

□ The CG6 graphics accelerator and the CG8 graphics board. 

□ SunDials, an image-manipulation device for Sun-3, Sun-4, and Sun-386i 
workstations. 

□ A 688-megabyte SMD disk packaged in the new Storage Pedestal Upgrade 
Drive (or SPUD). It is the same physical size as the existing Mass Storage 
Pedestal, but provides 2.5 times more storage. 

□ The high-performance VME/SMD disk controller which supports up to four 
disk drives. 
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New Software New software in SunOS Release 4.0.3 includes: 

□ GPSI (Graphics Processor Software Interface) enhancements, bringing 
features such as picking and depth-cued vectors to the Sim family of graph¬ 
ics processors. 

□ The sundiag program, a SunView-based diagnostic tool you can use to 
test and exercise system devices and peripherals. 

□ New mt (magnetic-tape device) command options for faster tape position¬ 
ing. 

bsfm Backspace n file marks, 

asf Absolute-space to count file mark, 

eom Space to the end of recorded media (SCSI only). 

Note that 1/2" tape drives with Tapemaster or Xylogics controllers emulate 
the asf by a rewind followed by an appropriate forward-skip. 

□ Preconfigured small kernels to eliminate the extra steps needed to customize 
the kernel on many smaller systems. 

□ The sunupgrade program, an interactive program supplied with the 
Upgrade SunOS 4.0.3 tape set to upgrade existing 4.0 (or later) installations 
to the newest release. 

The sunupgrade program is discussed more fully in the next section 
“New Program for System Upgrades.” Unless you have the upgrade tapes, 
however, you will use suninstall to perform a full installation of SunOS 
4.0.3 and can skip the sunupgrade section. 

The new sunupgrade program enables you to upgrade a 4.0 (or later) system 
to SunOS 4.0.3. You can use the program after copying the miniroot from the 
distribution tape as described in Installing the SunOS 4.0.3. (The program files 
reside in the /usr/etc/upgrade directory, which is unique to Upgrade 
SunOS 4.0.3.) 

You must use the Upgrade SunOS tape to perform a system 
upgrade. It is the only tape that includes the files for a sys¬ 
tem upgrade. 

See the section “Distribution Tape Layout” in the “Read Me First” for more 
information about the files supplied with the upgrade and full-install versions of 
SunOS 4.0.3. 


New Program for System 
Upgrades 
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1.2. Documentation 
Conventions 


This manual follows these conventions: 

□ System commands and messages, as well as SunOS filenames, appear in 
listing font like this. 

□ Information you type in response to the system is shown in bold 
listing font like this. 

□ Information you type that differs between users and systems is shown in 
bold italics like this. These variables often are in tables in the text, where 
you select the correct entry for your system. 

□ Document titles show in plain, nonbold, italic font. 

□ Dialogues between you and the system are enclosed in gray boxes, like this 
command to remove a file and the system request for confirmation: 

_ —- - -.. : . ....... .. . ...-----"N 

hostname % rm filename 
rm: remove filename! y 

s_:___ ' ___ - ’ 

□ Sections of program code show in plain listing font, enclosed in clear boxes: 
-~ 

int test[100]; 
main() 

{ 

register int a, b, c, d, e, f; 

test [a] = b & test[c & 0x1] & test[d & 0x1]; 

} 

V__ 
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Installing SunOS 4.0.3 and 
Pre-Configured Kernels 


2.1. Installation or 
Upgrade? 


Installing SunOS 4.0.3 


Upgrading to SunOS 4.0.3 


2.2. The sunupgrade 

Utility 


This chapter explains when to fully install SunOS 4.0.3 on your system, and 
when to upgrade your system to SunOS 4.0.3. Refer to the Installing the SunOS 
4.0.3 guide for system upgrade and complete system installation instructions. 
Installing the SunOS 4.0.3 also provides descriptions, instructions, and walk¬ 
through examples for the installation options. 

Note The SunOS distribution tapes are labeled. If the label specifies 

“Upgrade,” you must perform a system upgrade. If it does not, you 
must perform a full installation instead. See the next sections for more 
information. 


To migrate from SunOS 3.x to SunOS 4.0.3, or to install a new system, perform a 
full installation. A full installation installs an entire operating system, overwrit¬ 
ing the existing system files. 

See the Installing the SunOS 4.0.3 guide for full installation instructions. 


To migrate from SunOS 4.0 or 4.0.1 to this release, 4.0.3, perform a system 
upgrade using the upgrade utility, sunupgrade. 

When you perform a system upgrade, you selectively replace those files that are 
different between the release you are running and the new release to which you 
are migrating. 

See the upgrade chapter in Installing the SunOS 4.0.3 for upgrade instructions 
and walkthrough examples. 

The new sunupgrade program enables you to upgrade a 4.0 (or later) system 
to SunOS 4.0.3. You can use the program after copying the miniroot from the 
distribution tape as described in Installing the SunOS 4.0.3. (The program files 
reside in the /usr/etc/upgrade directory, which is unique to Upgrade 
SunOS 4.0.3.) 

You must use the Upgrade SunOS tape to perform a system 
upgrade. It is the only tape that includes the files for a sys¬ 
tem upgrade. 
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General Information 


Program Features 


See the section “Distribution Tape Layout” at the end of this document for more 
information about the files supplied with the upgrade and full-install versions of 
SunOS 4.0.3. 


As shown in the following screen, sunupgrade is an interactive program that 
prompts for information as it executes. (This excerpt is from Chapter 9 of Instal¬ 
ling the SunOS 4.0.3, which provides complete examples for many upgrade 
scenarios). 



□ Preserves and labels customized system files (such as those in /etc or 
/ var) so you can refer to them when customizing the new files. 

□ Allows for client files and directories to differ from standard Sun 
configurations. (Limitations apply; refer to Installing the SunOS 4.0.3 for 
details.) 

□ Asa safeguard, prevents you from upgrading a dataless client unless its 
server is already running SunOS 4.0.3. 

□ Builds data files for the install_small_kernel script, which is used 
to install the GENERIC_SMALL kernel as explained in Installing the 
SunOS 4.0.3 (see “Post-installation Procedures”). 

□ Takes advantage of the auto-density setting of the st driver. The 1/4" tape 
device is consistently referred to as stO. 

□ Restructures the filesystem to accommodate changes to the kvm directory 
structure (see “New kvm Layout Created by Sunupgrade,” later in this sec¬ 
tion, for details). 
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□ Runs in ‘ ‘no-rewind’ ’ mode to reduce installation time. This is the default 
for all local installations and for remote installations from l/4"-tape if the 
remote tapehost is running SunOS 4.0.3. You can, if desired, disable this 
feature when you invoke sunupgrade by including the -n (no rewind) flag 
on the command line. For example: 



When performing a remote upgrade from l/2"-tape or any 
remote upgrade where the tapehost is not running SunOS 
4.0.3, the sunupgrade program will automatically disable 
the “no-rewind” feature. 

Installing the SunOS 4.0.3 explains, step by step, how to use sunupgrade to 
upgrade your system software. See the sunupgrade(8) manual page in the 
Changes Pages and Addenda to the Docubox document set for complete infor¬ 
mation about sunupgrade syntax or command options. 

Supported Architectures Table 2-1 shows, by workstation type, the architectures that sunupgrade sup¬ 

ports. 


Table 2-1 Architectures Supported by sunupgrade 


Workstation 

Type 

Architecture 

Supported? 

Sun-2/xO 

68010 

sun2 

yes 

Sun-3/50 

68020 

sun3 

yes 

Sun-3/60 

68020 

sun3 

yes 

Sun-3/75 

68020 

sun3 

yes 

Sun-3/80 

68030 

sun3x 

no 

Sun-3/1x0 

68020 

sun3 

yes 

Sun-3/2xO 

68020 

sun3 

yes 

Sun-3/Eurocard (or Sun-3/E) 

68020 

sun3 

yes 

Sun-3/4x0 

68030 

sun3x 

no 

Sun-4/1 xO 

SPARC 

sun4 

yes 

Sun-4/2x0 

SPARC 

sun4 

yes 

SPARCstation 330 

SPARC 

sun4 

yes 


Because the sun3x architecture is new with SunOS 4.0.3, it is not supported by 
sunupgrade and requires a full installation. 
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New kvm Layout Created by To better group minor architecture-dependent executables, the kvm directory 

Sunupgrade now contains the /usr/boot, /usr/mdec, and /usr/stand directories. 

The older directories have been replaced by symbolic links that point to the new 
locations. 

An example of an upgraded system follows: 


_________- ;—— . ; . — -:-;-\ 

tofu% cd /usr 

tofu% Is -1 boot mdec stand 

Irwxrwxrwx 1 root 8 Apr 20 14:15 boot ->: kvm/boot 

lrwxrwxrwx 1 root 8 Apr 20 14:15 mdec -> kvm/mdec 

Irwxrwxrwx 1 root 9 Apr 20 14:15 stand -> kvm/stand 

i ’ ’ • • _ • _ j 

The following changes apply to clients of a server: 

□ The /export/exec/urc/t/kvm directory has been moved to 
/export/exec/kvm/arc/i 

(<arch stands for sun3, sun4, and so on). 

□ The following directories have been moved, as subdirectories, to 
/export/exec/kvm /arch: 

□ /export/exec/kvm/ arch/boot (old location) 

□ /export/exec/kvm /arch/mdec (old location) 

□ /export/exec/kvm/arc/i/stand (old location) 

o The /export/exec/kvm/arc/t directories are now mounted on the 
/ usr/kvm directory of the client. 

□ The older boot, mdec, and stand directories have been replaced by sym¬ 
bolic links that point to the new locations (as if the directories were mounted 
by clients). 

Here is an example of an upgraded sun3 server exec directory: 


tofu% cd /export/exec 

tofu% Is -F 

kvm/ sun2/ sunSS sun4/ 

t<$iu% Is —F kvm 
sun2/ sun3@ sun4/ 

tofu% cd /export/exec/sun4 
tofu% Is -X boot mdec stand 

Irwxrwxrwx 1 root 8 Apr 25 11:02 boot -> kvm/boot 

Irwxrwxrwx 1 root 8 Apr 25 11:02 mdec -> kvm/mdec 

Irwxrwxrwx 1 root 9 Apr 25 11:02 stand ~> kvm/stand 

tofu% Is -1 kvm 
total 0 

y _:___;_ 


The sunupgrade program makes the necessary changes to the filesystem and 
then edits the server /etc/exports file and the client f stab file to record 
the changes. 
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Here is an example of a client’s /etc/f stab file after an upgrade: 

tofu% cat /export/root/egg/etc/fstab 

tofu:/export/root/egg / nfs rw 0 0 
tofu:/export/exec/sun3 /usr nfs ro 0 0 
tofu:/export/exec/kvm/sun3 /usr/kvm nfs ro 0 0 
tofu: /export/share /usr/shate nfs: ro 0 0, • . 

tofu:/home/tofu /home/tofu nfs rw 0 0 
#tofu:/export/crash /var/crash nfs rw 0 0 , 

• _ liglll I 1 IS ■••••• - • • ’ _ ■ J 


In addition to the large default GENERIC kernel supplied with the SunOS 4.0.3, 
four pre-configured kernels for small systems are also provided. Kernel 
configuration options are briefly covered below, and are fully discussed in the 
Installing the SunOS 4.0.3 guide. 


Configuring your kernel or using one of the supplied configurations can 
significantly improve system performance. 


After either an upgrade to SunOS 4.0.3 or a full SunOS installation, you have a 
large default GENERIC kernel. The GENERIC kernel contains all device 
drivers and options, including many that you might not need. 


You have four choices of kernels to run after installation: 

□ The large default GENERIC kernel (not recommended) 

□ Four preconfigured small system kernels that you do not need to build 

□ Sun-supplied kernel configuration files that simplify building a custom 
kernel 

o A custom kernel that you build 


Pre-configured small system kernels are listed below. 

□ Sun-2: 2/50 Diskless or with up to two SCSI disks and one SCSI tape 

o Sun-3 (68020-based systems): 3/50 and 3/60 diskless or with up to two SCSI 
disks and one SCSI tape 

□ Sun-3x (68030-based systems): 3/80 diskless or with up to two SCSI disks, 
one SCSI tape, and one floppy drive 

□ Sun-4:4/110 or SPARCsystem 330 with up to four SCSI disks and one SCSI 
tape 
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Supplied Configuration Files Many convenient kernel configuration files are supplied in 

/usr/sys/sun ARCH/ conf. ARCH is 2,3,3x or 4 for Sun-2, Sun-3 (68020- 
based), Sun-3x (68030-based), and Sun-4 systems, respectively. These 
configurations are for common systems, and allow you to rebuild a custom kernel 
more easily. 

In /usr/sys/sunARCtf/conf, file names beginning with DL are for disk¬ 
less systems. Names beginning with SDST are for SCSI disk and tape, and XD 
and XY files support Xylogics disk controllers. 


2.4. Pre-installation Issues This section contains supplementary information you may need in order to suc¬ 
cessfully install or upgrade to SunOS 4.0.3. in the following situations: 

□ Upgrading a server with diskless or dataless sun3x clients (these are the new 
Sun-3/80 and SPARCsystem 300 systems). 

□ Installing SunOS 4.0.3 on a Sun-4 full heterogeneous server, in other words, 
a server with clients of all four architectures. 

□ Installing SunOS 4.0.3 on a Sun-3/E heterogeneous server with Sun-2 
clients. 

□ Installing or upgrading to SunOS 4.0.3 on a Sun-3/E from 1/4" tape. 

□ Installing or upgrading a server with client directories in several locations. 

□ Remotely installing or upgrading to SunOS 4.0.3 on woikstations that have a 
CG8 frame buffer or a Storage Pedestal Upgrade Disk (SPUD). (These 
features were described earlier under “New Release Features.”) 

□ Loading SunOS 4.0 (or later) on an older Sun-3 from 1/4" tape. 

□ Upgrading systems using the ALM-2 parallel port. 

Read the corresponding section before you begin an upgrade or installation as 

explained in Installing the SunOS 4.0.3. 

NOTE suninstall and sunupgrade can only be invoked from the miniroot. 

Before using sunupgrade ,you should also read about disk-space requirements in 

Chapter 9, “Performing a System Upgrade,” of Installing the SunOS 4.03. 


Upgrading a Server with If you have a server which already supports Sun-3X clients (running SunOS 4.0.3 

Diskless or Dataless Sun-3X beta), call the Answer Center for instructions to upgrade to SunOS 4.0.3. 

Clients 


Installing SunOS 4.0.3 on a A suninstall problem will abort the installation if you try to install the sun2 

Sun-4 Full Heterogeneous software last You can work around the problem by installing the software in any 

Server other order. 
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Installing SunOS 4.0.3 on a 
Sun-3/E Heterogeneous 
Server with Sun-2 Client 


You cannot successfully use suninstall to configure a Sun-3/E as a hetero¬ 
geneous server if its clients include Sun-2 systems. You can work around this 
problem in two ways. 

1. You can use suninstall to configure the Sun-3/E as a homogeneous 
server and then use setup_exec to install the Sun-2 executables. 

2. You can remotely install the Sun-3/E as a heterogeneous server. 

Installing the SunOS 4.0.3 explains how to use setup_exec (see Chapter 8, 
“Advanced Installation Issues”). The latest setup_exec(8) and 
setup_client manual pages accompany this document 


NOTE If you are installing SunOS 4.0.3 on a Sun-3/E from local H4“ tape, additional 

considerations apply. See the next section for details. 


Installing or Upgrading to 
SunOS 4.0 (or later) on a 
Sun-3/E from 1/4" Tape 


To Perform a Full Sun-3/E 
Installation from Local 1/4" 
Tape 


When you load a tape, the SCSI tape drive automatically selects QIC-11 or QIC- 
24 format but the Sun-3/E does not support this feature. The Sun-3/E SCSI host 
adapter assumes QIC-11 (st 0) even though the SCSI drive is set for QIC-24 
(st8). 

To install or upgrade to SunOS 4.0.3, all st8 devices must be symbolically 
linked with their st 0 counterparts as described in this section. Your distribution 
tapes include a script to set up the necessary links and, optionally, to remove 
them. 

□ The script is /usr/etc/install/ln_sun3e_st on the full-install 
tapes. 

□ Thescriptis /usr/etc/upgrade/ln_sun3e_st on the upgrade tapes. 

The script is for local installations and upgrades only. For a remote installation 
or upgrade in which the Sun-3/E is the remote tape host, you must set up the 
links yourself. The sections that follow provide both local and remote pro¬ 
cedures. 

1. With the exception noted, follow the instructions in Installing the SunOS 
4.0.3 up to the point where you have booted vmunix from the miniroot. 

Exception: When you load MUNIX from tape, follow this example instead 
of the one in Chapter 4, substituting st 8 for st 0 as shown: 


f ----•-\ 

> b at () 

Boot: at (,, 4) 

init rant disk from davica (st%d[a-h] sd%d[a-hj £t%d[a-h]: at8 
Tapa fila numbar? 5 

i _:___>___;_ ESI __ „ > 

2. While in the miniroot, create the necessary links as follows: 
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rm .—:.; —.— ,— 1 ...—. 1 1 , ■—— — .— -________ 

# cd /uar/etc/inatall 

# ah ln_sun3e_st 

3. Run suninstall as described in Installing the SunOS4.03. 

The installation is complete unless the Sun-3/E will be a heterogeneous server 
with clients. In this case, do the following after the system is booted. 

■ ' ~ ■ .... . ... ; ........... .... ■) 

!|||:; #/usr/etc/install/ln__aun3e_at 


4. Run the setup_exec utility as described in Installing the SunOS 4.0.3 to 
configure your system as a heterogeneous server with clients. (See Chapter 
8, “Advanced Installation Issues,” for details.) Also see the latest 
setup_exec(8) and setup_client(8) manual pages, which accom¬ 
pany this document. 

5. Remove the links created at step 3. 

r~ —■—- t ——“—■— -:-:-;-;-;— -\ 

# /usE/etc/install/unln_sun3e_st 


To Perform a Sun-3/E System 
Upgrade From Local 1/4" Tape 


If you are performing a local Sun-3/E upgrade, follow these steps: 


1. Load and boot the mini-root from the Upgrade tape and then execute the 
ln_sun3e_st script 


# cd /uar/etc/upgrade 

# ah in sun3e at 


2. Use sunupgrade to upgrade your system as described in Chapter 9 of 
Installing the SunOS 4.0.3. 

If the Sun-3/E is a remote tape host, follow these steps instead: 

1. Enter the following series of commands: 

cd /dev 

:: #\:.rm -£ *at0 ' . 

!!!!|:f ? ||n -a at8 atO 

# In -s rst8 ratO 

# in -a nrat8 nratO 

s.. . . ■ ■ • . 

2. Use sunupgrade to upgrade your system as described in Chapter 9 of 
Installing the SunOS 4.0.3. 
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Upgrading a Server with 

Client Directories in Several 
Locations 

See Chapter 9 of Installing the SunOS 4.0.3 for a workaround procedure. 

Remotely Installing or 

Upgrading Workstations with 
a CG8 Frame Buffer or SPUD 

The temporary server from which you boot as a diskless client must already be 
running SunOS 4.0.3. 

Loading SunOS 4.0 (or later) 
on a Sun-3 from 1/4" tape 

l 

1 

A few older Sun-3 systems fail to boot or return errors when you try to load 
SunOS 4.0 (or later) from a 1/4" tape drive. If this happens, follow these steps. 

1. To check the revision level of the PROM, enter kb at the PROM monitor 
prompt (>). 

In response, the system displays a series of messages, for example: 

. •-— - . — : ; ;: ... ■. ~ .... ,* ; y: , ..a - —-> 

> kb . t 

Self Test completed successfully. * 

Sun Workstation, Model some number 

ROM Rev 1,8, SMB memory 

and so on ... ilSllllllllli 

2. Compare the ROM revision number (1.8 in the example) with that listed 
for your architecture in Tables 2-2 and 2-3. If the number is less than the 
minimum level shown, upgrade your PROM as described in step 3. If the 
number is greater than 1.8 but lower than 2.6, and you still cannot boot 
successfully, see the “PROM Issues” section that follows step 3. See also 
the PROM User’s Guide. 

3. If an upgrade is needed, you have several options. 

a. You can have Sun install the PROM for you. (The upgrade is free if 
you have an On-Site Hardware or Comprehensive Support Contract.) 

b. You can order an upgrade kit, and install the PROM yourself. The kit 
explains how to replace the boot PROM on your CPU board, a process 
which takes ten or fifteen minutes. 

Call 800-USA-4SUN, request Field Service, and schedule PROM installation or 
order a Sun-3 PROM Upgrade Kit. (Outside the USA, call your local support 
office.) 

PROM Issues 

i 

If the revision of your PROM is between 1.8 and 2.6 and you still cannot boot 
from 1/4" tape, the problem could be caused by one of the anomalies described 
here: 

□ If your system contains a Sysgen controller board and a Wangtek tape drive, 
and if the tape you are trying to load is write-protected, you will receive an 
error message with status 96A0. 
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To boot, remove the tape from the drive, write-enable the tape by turning the 
write-protect key so it points away from SAFE, mount the tape in the drive, 
and boot again: 

> b st (0,0,0) 

Once the initial boot completes, protect the tape again by turning the write- 
protect key to SAFE. 

If the boot still fails, contact Hardware Support at 1-800-USA-4SUN. (Out¬ 
side the USA, call your local support office.) 

Reference FA 136 when you call. 

□ If you have a Sysgen controller and an Archive tape drive and your PROM 
revision level is between 1.8 and 2.6, call Sun as described earlier to 
request the latest revision PROM. 

Reference FA 135 when you call. 

□ If you have a Sun-3 workstation with a Sun-2 Mass Storage Subsystem and 
receive a tape error, call Sun as described earlier. 

Reference FA 137 and 138 when you call. 


Table 2-2 Minimum PROM Revision Levels 


System 

Architecture 

Minimum 
PROM Level 

Sun-3/50 

1.8 

Sun-3/60 

1.6 

Sun-3/75 

1.8 

Sun-3/80 

2.9 

Sun-3/110 

1.8 

Sun-3/140 

1.8 

Sun-3/150 

1.8 

Sun-3/160 

1.8 

Sun-3/180 

1.8 

Sun-3/260 

1.8 

Sun-3/280 

1.8 

Sun-3/470 

2.9 

Sun-3/480 

2.9 


NOTE Table 2-3 supersedes this table for some systems and hardware configurations. 
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Table 2-3 


Minimum PROM Revisions for Special Configurations 


PROM Level 

Hardware Configuration 

2.7 

You use a 7053 VME/SMD disk controller with 
one of the following workstations: Sun-3/75, 
Sun-3/140, Sun-3/150, Sun-3/160, Sun-3/180, 
Sun-3/260, or Sun-3/280. 

2.9 

Your system has a P4-bus graphics board, such 
as the CG6 or the CG8. (See the SunOS 4.0.3 
Release Manual for general information about 
the CG6 and CG8.) 


Installing or Upgrading to the 
Correct ALM-2 Device Files 



In SunOS 4.0.3, the major and minor device numbers for the ALM-2 Parallel 
Printer port have been changed. The old numbers were major device 66 and 
minor devices 0 through 3. When installing a new system, the correct device 
flies (/dev/mcppO through /dev/mcpp3) will be created when you install the 
ALM-2 and run /dev/MAKEDEV. When upgrading an existing system with 
ALM-2, it is necessary to remove the existing /dev/mcppO, /dev/mcppl, 
/dev/mcpp2, and /dev/mcpp3 entries and re-create them using the 
/dev/MAKEDEV before accessing the parallel ports. 


2.5. Post-installation Issues This section discusses issues that may concern you after you have installed 

SunOS 4.0.3. These include: 


□ Installing a Yellow Pages server. 

□ How to add software or support for new architectures. 

□ How to install SunDials. 

□ How to install SunLink products, plus special procedures for the Internet¬ 
work Router (INR) and the Multiprotocol Communication Processor (MCP). 

□ How to verify CG8 installation, plus information about CG8 compatibility. 

The section begins with general information about setting up a yp server. At the 
end of the section, you will find a list of files you can remove after you have run 
the sunupgrade program. 


Installing a yp Server After installing a yp server, be sure to complete the following steps before you 

boot the clients. 

1. Run /usr/etc/yp/ypinit on the server. 

2. As root, edit the /et c/rc. local file on the server, and remove the # 
signs from the code that tests for ypbind: 
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Adding Software or 
Architecture Support 


Loading Operating System 
Software 






> 

#if 

[ -f /usr/etc/ypbind ]; then 



# 

if [ -f /etc/security/passwd.adjunct 

]; then 


# 

ypbind -s; 

(echo -n ' ypbind') 

>/dev/console 


# 

else 




# 

ypbind; 

(echo -n ' ypbind') 

>/dev/console 


# 

fi 




#fi 





s 




j 


3. Execute ypbind or reboot the server. 


In order to add software, you need either a set of SunOS 4.0.3 full-install tapes or 
the following tapes: 

□ A set of SunOS 4.0 full-install tapes. 

□ A set of SunOS 4.0.3 upgrade tapes (these are the tapes labeled “Upgrade’ ’). 

Use the SunOS 4.0.3 full-install tapes if they are available; otherwise, the follow¬ 
ing steps are recommended: 

1. Run setup_client or setup_exec, as appropriate, from the SunOS 
4.0 full-install tapes. 

2. Run sunupgrade from the upgrade tapes, upgrading the new software 
along with the entire file system. 

Installing the SunOS 4.0.3 explains how to use setup_exec and 
setup_client (see Chapter 8, “Advanced Installation Issues”). For com¬ 
plete syntax, see the latest setup_exec(8) and setup_client(8) manual 
pages, which accompany this document. 

CAUTION: Do not attempt to install software or architectures that are not 
supported in SunOS 4.03. 

The next section provides useful information about hardware architectures, plus 
setup_exec and setup_client examples to help you configure your sys¬ 
tem. 

Note for Sun-3/E Users: To extract additional software or architecture support 
for the Sun-3/E, you must execute /usr/etc/install/ln_sun3e_st 
before you run setup_exec and do the following after you run it: 

# /usr/etc/install/unln_aun3e_at 


The Sun-3/80,470, and 480 are based on the new sun3x architecture. The sun3x 
systems have the same application architecture as the sun3 systems, that is, they 
are binary compatible at the user level. The systems differ in kernel architecture, 
that is, programs that assume knowledge of kernel structures will have to be 
recompiled when moved between sun3 and sun3x systems. 

Hosts with the same architecture but different kernel architectures can share most 
executables. The executables that depend on a particular kernel layout reside in a 
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Using setup_exec and 
setup_client to Add 

Software and Clients to an 
Installed System 


new directory, /usr/kvm, which is not shared across kernel-architectures. On a 
server, these kemel-architecture-dependent files reside in 
/export/exec/kvm. Diskless clients must therefore mount 
/export/exec/kvm as well as /usr (in other words, /usr is mounted and 
then /export/exec/kvm is mounted on top of /usr/kvm). 

To accommodate the kernel-architecture differences, you must specify two paths 
when you install a client. 

□ The execpath to identify the directory in which the application- 
architecture-dependent executables reside. 

□ The kvmpath to identify the directory in which the kemel-architecture- 
dependent executables reside. 

The execpath is unchanged from SunOS 4.0. By default, it is one of the fol¬ 
lowing: 


f 

/usr 

or 

/export/ exec /kernel ARCH 

\ 

(for standalone systems) 

(for servers) 

J 

The kvmpath is new in SunOS 4.0.3. 

By default, it is one of the following: 

r 

/usr/kvm 

\ 

(for standalone systems) 

or 


/export/exec/kvm /kernelARCH 

(for servers) 

v 

J 


When you run suninstall, you specify both paths on the Host Form, 

Software Form, and Client Form. When you use the setup_exec and 
setup_client utilities, you specify the paths on the command line. 

Because sun3 and sun3x systems share all executables except kernel code, only 
the kvm and sys files differ between the sun3 and sun3x SunOS tapes. The fol¬ 
lowing case examples show how to load additional software on a system that is 
up and running in multiuser mode. 

The system prevents you from loading duplicate software categories that can be 
shared across similar architectures. You can use the -o option of the 
setup_exec utility to override this safety mechanism in order to reselect and 
subsequently reload a software category. For details, see the latest 
setup_exec(8) and setup_client(8) manual pages, which accompany this 
document. 

Note: In all cases where the software is added from SunOS 4.0 release tapes, 
mn sunupgrade after the software is loaded. 

Case 1 : sun4 Server 

□ To load sun3 executable files, do the following: 
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Extract at least the required or default categories. 

□ After you load the sun3 executable flies, if you want to add sun3x support, 
do the following: 

f - T_— ”—. • ...—~~"—;— -. ....... ■ “ ■ . .... •. — “ ; ; ■ > 

aatup_axac sun3x /axport/axac/sun3x/axport/axac/kvm/sun3x 


The system will let you extract the kvm and sys categories, but prevents 
you from loading duplicate categories, because the sun3 and sun3x architec¬ 
tures share the other executables in /export/exec/sun3. 

□ To add a sun3 client, do the following (the backslash indicates the command 
continues on the next printed line; you do not need to type it): 
---> 

satup_cliant add client oliant 16m /axport/root /axport/swap \ 
/homa /axport/axac/sun3 /axport/axac/kvm/sun3 sun3 


□ To add a sun3x client, do the following: 

satup__cliant add client client 16m /axport/root /axport/swap \ 
/home /export/axec/*un3x /axport/axac/kvm/sun3x «un3x 


Cose 2 : sun3 Server 

□ To load the sun3x executable files, do the following: 

r -;——— -:- — —:———■ , —. . .. -.. — _■. ... .. —-\ 

aatup_axac sun3x /export/exec/aun3x /axport/axac/kvm/sun3x 

The system will let you extract the kvm and sys categories, but prevents 
you from loading duplicate categories, because the sun3 and sun3x architec¬ 
tures share the other executables in /export/exec/sun3. 

□ To load the sun4 executable files, do the following: 

(~——’— -:—;-— 1 ——-;-;-s 

satup_axac sun4 /axport/axac/aun4 /axport/axac/kvm/sun4 

Extract at least the required or default categories. 

□ To extract additional sun3 executable files, do the following: 

setup_exec sun3 /export/exec/sun3 /export/exec/kvm/sun3 

s._____/ 

Extract the additional software you need. The system will prevent you from 
reselecting categories that were previously loaded. 
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□ To add a sun3x client, do the following (the backslash indicates that the 
command continues on the next printed line; you do not need to type it): 

/ ' ' ” : ..... ..... . ....; ... —;—\ 

aetup_client add client client 16m /export/root /export/swap \ 
/horn* /export/exec/*un3x /export/exec/kvm/aun3x aun3x 

v_---_---;---—• • • '- -•: • • V - ’• :X - ""‘ • j 

□ To add a sun3 client, do the following (the backslash indicates that the com¬ 
mand continues on the next printed line; you do not need to type it): 

r .. ■■ ■ "... ■ „ .., - ... ■■ . : .-----"\ 

setup_client add client cliant 16m /export/root /export/swap \ 
/homa /axport/axac/sun3 /export/exec/kvm/aun3 aun3 

v_, 

□ To add a sun-4 client, do the following (the backslash indicates that the 
command continues on the next printed line; you do not need to type it): 

*atup_cliant add client cliant 16m /axport/root /axport/awap \ 
/homa /axport/axac/sun4 /axport/axac/kvm/sun4 sun 4 
V_•_> 


Case 3 : sun3x Server 

□ To load the sun3 executable files, do the following: 

setup^exec sun3 /export/exec/sun3 /export/exec/kvm/sun3 

The system will let you extract the kvm and sys categories, but prevents 
you from loading duplicate categories, because the sun3 and sun3x architec¬ 
tures share the other executables in /export/exec/ sun3. 

□ To load the sun4 executable files, do the following: 



□ To extract additional sun3x executable files, do the following: 

-—— — -;-—-: ————---;—-———\ 

setup_exec sun3x /export/©xec/sun3x /«xport/axac/kvm/sun3x 

______ ■' _____ V 

Extract the additional software you need. The system will prevent you from 
reselecting categories that were previously loaded. 

□ To add a sun3 client, do the following (the backslash indicates the command 
continues on the next printed line; you do not need to type it): 

-^ 

setup__client add client client 16m /export/root /export/swap \ 
/home /export/exec/sun3 /export/exec/kvm/aun3 aun3 

k ___* 1 ._ j 

To add a sun3x client, do the following (the backslash indicates the com¬ 
mand continues on the next printed line; you do not need to type it): 


#sun 
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s«tup_cliant add client client 16m /export/root /export/swap \ 
/homo /export/exec/«un3x /export/exec/kvm/sun3x sun3x 

- ___-J 

□ To add a sun4 client, do the following (the backslash indicates the command 
continues on the next printed line; you do not need to type it): 

r~ — - —“—“tt—”—-—:-- ~ : ■ —— .. . T” ■ ■ : — > 

8etup_olient add client client 16m /«xport/root /export/swap \ 
/homo /«xport/«xac/eun4 /oxport/oxoc/kvm/sun4 sun4 


Installing SunDials Install the dialbox as follows: 

1. Link to the serial port to which the SunDials device has been connected, 
for example: 


:■ ------ 

# In -s /dev/ttya /dev/dialbox 




\ 






2. Enter the following command: 

f 1 "" > 

# /usr/etc/dbconf /dev/dialbox 


After installation, you can run the Sundials test program in the 
/usr / demo/DIALBOX directory. 

Installing SunLink Products When installing some 6.0 and 6.1 SunLink products, you must run the script 

/usr/etc/sunlink. install after you run extract_unbundled, 
but before you run the product-specific installation script. If you do not run 
sunlink. install, the product-specific scripts fail. 

The new installation steps are as follows: 

1. Run /usr/etc/extract_unbundled to extract the product off the 
tape. 

2. Run /usr/etc/sunlink. install, selecting the product being 
installed. 

3. Run any product-specific installation or configuration scripts according 
to the product documentation. 

Table 2-4 lists the affected SunLink products. 
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Table 2-4 Run sunlink. install for These Products 


6.1 BSC3270 
6.0 BSCRJE 
6.0 Channel Adapter 
6.0 DDN 
6.0 DNI 

6.0 HSI _ 

6.0 INR* 

6.0 MCP* 

6.0 Peer-to-Peer 
6.0 SCP 
6.1 SNA3270 


There may be additional steps for these products. See the next sections for 
details. 


Installing the Internetwork If you are installing the SunLink Internetwork Router on a system that is run- 

Router ning SunOS version 4.0.3, you must perform the following step: 

After you run the extract_unbundled and sunlink. install 
scripts, but before you run the install, inr script, enter the following 
command as root: 


# mn /uar/aunlink/inr/aya/arc/i/OBJ/ln pcb. o 


where arch is a directory name that designates your machine architecture, for 
example, sun4 for a Sun-4. You can then proceed to run install. inr as 
documented in the SunLink Internetwork Router System Administration 
Guide. 

Installing the MCP on Sun-3/400 If you are installing the SunLink MCP (Multiprotocol Communication Pro- 
Series cessor) software on a Sun-3/470 or Sun-3/480 workstation that is running 

SunOS version 4.0.3, you must perform the following steps: 

After you run the extract_unbundled and sunlink. install 
scripts, but before you run the install, mcp script, enter the following 
commands as root: 
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.. : : : L ; 

# cd /usr/sunlink/mcp/sys 

# cp GENERIC.mcp.add temp 

# chmod +w GENERIC.mcp.add temp 

# sed 's-16-32-' temp > GENERIC.mcp.add 

_ 


You can then run install. mcp as documented in the SunLink MCP 
Installation and Configuration Guide. 


CG8 Installation and Issues This section explains how to verify that the CG8 is successfully installed and 

presents important information about its operation. 

Verifying a Successful Installation When you have installed the tape, the boot-up messages should include 

CG8-specific information. Most likely, you will see the following lines: 



> 

cgeightprobe: 1152 x 900 


cgeightO at obio 0xfb300000 


V 

J 


On the Sun-3/80, Sun-3/470, or Sun-3/480, you should see these similar lines 
instead: 


r 

\ 

cgeightprobe: 1152 x 900 


cgeightO at obmem 0x50300000 


V 

-J 


Run the following checks to verify that the installation was successful. 


First, check the Pixrect libraries. For 24-bit support, the files listed below 
must exist (at the revision levels shown or higher). 


f 

% Is /usr/lib/libpixrect* 



N 

/usr/lib/libpixrect.a 
/usr/lib/libpixrect.sa.2.4 
/usr/lib/libpixrect.so.2.4 



J 


Now, make sure that the CG8 device is installed: 

r -•-------\ 

example% Is -1 / dev/cgeightO 

crw-rw-rw- 1 root 63, Q Apr 10 00:44 /dev/cgeightO 

V_ J 

If there is no CG8 device, use MAKEDEV to create it as shown here: 


% su 

Password : enter root password 

# cd /dev 

# MAKEDEV cgeight 
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You should now be able to run 24-bit color applications. 

CG8 Compatibility Issues 

Major compatibility issues exist with color applications running on the CG8 
color board. Pixrect and SunView 1 color applications must be modified 
before running on the CG8 color frame buffer. See the “Documentation 
Errata and Change Pages for SunOS Release 4.0.3“ for details. 

The CG8 is not recognized by the screenload, screendump, and 
clear_colormap utilities and may not be recognized by other pixrect- 
based utilities (it depends on how they are written). 

Unneeded Files After a System 
Upgrade 

The sunupgrade program creates a number of files that you may wish to 
remove after upgrading your system. They are listed below. 

Sun2 Upgrade 

You can remove the following files after upgrading a Sun-2 system: 

/usr/kvm/libkvm.sa.0.2 
/usr/kvm/libkvm.so.0.2 
/usr/lib/libkvm.sa.0.2 
/usr/lib/libkvm.so.0.2 
/usr/51ib/libc.sa.1.10 
/usr/51ib/libc.so.1.10 
/usr/lib/libc.sa.0.10 
/usr/lib/libc.so.0.10 
/usr/lib/libpixrect.sa.2.2 
/usr/lib/libpixrect.so.2.2 
/usr/lib/libsuntool.sa.0.30 
/usr/lib/libsuntool.so.0.30 
/usr/lib/libsunwindow.sa.0.27 
/usr/lib/libsunwindow.so.0.27 


#sun 
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Sun-3 Upgrade 

You can remove the following files after upgrading a Sun-3 system: 

/usr/51ib/libc.sa.1.10 
/usr/51ib/libc.so.1.10 
/usr/lib/libc.sa.0.10 
/usr/lib/libc.so.0.10 
/usr/lib/libkvm.sa.0.2 
/usr/lib/libkvm.so.0.2 
/usr/lib/libpixrect.sa.2.2 
/usr/lib/libpixrect.so.2.2 
/usr/lib/libsuntool.sa.0.29 
/usr/lib/libsuntool.so.0.29 
/usr/lib/libsunwindow.sa.0.26 
/usr/lib/libsunwindow.so.0.26 


Sun-4 Upgrade 

You can remove all of the following files after upgrading a Sun-4 system. 
After all upgrades, you can remove all of the files after and including bin- 
mail. 1 on any system which has Man Pages installed. 

/usr/51ib/libc.sa.2.1 
/usr/51ib/libc.so.2.1 
/usr/lib/libc.sa.1.1 
/usr/lib/libc.so.1.1 
/usr/lib/libkvm.sa.0.2 
/usr/lib/libkvm.so.0.2 
/usr/lib/libpixrect.sa.2.2 
/usr/lib/libpixrect.so.2.2 
/usr/kvm/libkvm.sa.0.2 
/usr/kvm/libkvm.so.0.2 
/usr/share/man/manl/binmail.1 
/usr/share/man/manl/oldccat.1 
/usr/share/man/manl/oldclocktool.1 
/usr/share/man/manl/oldcompact.1 
/usr/share/man/manl/oldeyacc.1 
/usr/share/man/manl/oldfilemerge.1 
/usr/share/man/manl/oldmake.1 
/usr/share/man/manl/oldperfmon.1 
/usr/share/man/manl/oldprmail.1 
/usr/share/man/manl/oldpti.1 
/usr/share/man/manl/oldsetkeys.1 
/usr/share/man/manl/oldsun3cvt.1 
/usr/share/man/manl/oldsyslog.1 
/usr/share/man/manl/oldtektool.1 
/usr/share/man/manl/oldttytool.1 
/usr/share/man/manl/olduncompact.1 
/usr/share/man/manl/oldvc.1 
/usr/share/man/man3/string.3 
/usr/share/man/man5/resolve.conf.5 
/usr/share/man/man5/types.5 
/usr/share/man/man8/sysdiag.8 
/usr/share/man/man8/timed.8c 
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SCSI Drivers After installation, the following information is of interest if your system is 

equipped with a SCSI disk: 

□ The MTIOCGET tape io ct 1 structure has been changed so that the 
DMA residue variable (resid) is the same length as the transfer request 
variable. Compatibility with the older data structure will be provided for 
a short time only by the st, st, and tm tape drivers. 

□ The s c s i_c 11 r data structure has been changed to reserve space for 
storage of the interrupt priority and phase-log-tracking mechanisms. 

You will need to recompile any custom driver sources as a result of this 
change. No coding changes to these custom drivers should be required. 

□ Auto-disk repair is now enabled for the SCSI driver. You can, if you 
wish, disable this function with the following command: 


-s 

% echo "sd_repair?2 0" | adb -w sd.o 

_;_;_____;___ •: . j 
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Software Changes in SunOS 4.0.3 


3.1. New Feature —mt 
Command Options 



3.2. Enhanced Diagnostic 
Software 

The sundiag Program 


This chapter describes software changes in SunOS 4.0.3. 

The mt (1) command supports these new options. For complete information, 
see the updated manual page shipped with SunOS 4.0.3. 

bsfm Back space count file marks. The tape is positioned on the beginning- 
of-tape side of the file mark. 

asf Absolute space to count file number. 1/4" cartridge drives skip directly 
from the current tape position to the requested file number. On 1/2" 
drives, the command is equivalent to a rewind followed by an f sf 
count. 

eom Space to the end of recorded media on the tape (SCSI only). This is 
useful for appending files onto previously written tapes. 

SunOS 4.0.3 includes a new diagnostic system, sundiag. This is a SunView- 
based user interface that tests system devices and peripherals. 

The sundiag program is an online system exerciser for testing peripheral 
devices. Incorporating a SunView-based interface, sundiag can be used on 
any Sun-2, Sun-3, or Sun-4 hardware configuration running SunOS 4.0 and later. 
Configure the system kernel to support all peripheral devices to be tested. 

sundiag executes system tests that formerly were performed by sysdiag, 
and runs all sundiag tests written for new Sun products. Read the Sundiag 
User’s Guide, Part Number 800-3804, for complete information about using this 
test program. The sundiag program is in the /usr/diag/sundiag 
directory. 


3.1. New Feature —mt 
Command Options 



3.2. Enhanced Diagnostic 
Software 

The sundiag Program 
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3.3. Programs Moved to 

/usr/old 

The following is a list of programs moved to /usr /old. Programs moved to 
/usr/old will not be incuded in subsequent releases of the SunOS. 

sysdiag 

The sysdiag utility is being replaced with the new sundiag utility, a 
window-based diagnostic exerciser. For SunOS 4.0.3, sysdiag is moved to 
/usr/old. 

perfmon 

The perfmon utility was moved to /usr/old/perfmon in SunOS 4.0. 

setkeys 

The setkeys program is being phased out of SunOS and replaced by the input 
function in the default sedit program. The setkeys utility was moved 
to /usr/old/setkeys in SunOS 4.0. 

NOTE: 

/usr/old/ setkeys does not work with the Type-4 keyboard shipped with 
the new Sun hardware. 

3.4. New Software for New 
Hardware 

The following software features have been added to, or changed in, SunOS 4.0.3. 

New arch Options 

The arch command includes the new option, -k. Executing arch -k 
prints the kernel architecture type, such as sun3 (for 68020-based systems) or 
sun3x (for 68030-based systems). This indicates the UNIX® kernel that runs 
on the machine, and is important only for programs explicitly depending on the 
kernel architecture. 

The archname option is also new to the arch command. The command 
arch archname returns true when the machine can run the application 
binaries of the archname machine architecture, and returns false when it 
cannot run those binaries. 

For example, arch sun3 returns true on both Sun-3 and Sun-3x kernel 
architectures because these machines are binary compatible for application 
software. 

See Section 4.3, Differences Betweeen Sun-3 (68020-based) and Sun-3x (68030- 
based) Workstations for an explanation of the term “kernel architecture.” See the 
new ar ch (1) manual page in the Change Pages and Addenda to the Docubox 
document set for details of the new arch command options. 

Enhancements to make 

The make (1) command is enhanced in the way it assigns the output of shell 
commands to variables. With these changes, the make command takes advan¬ 
tage of new arch (1) features. 

See the new make (1) manual page in the Change Pages and Addenda to the 
Docubox document set for new information. 
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Entries in /et c/ f stab and Because of changes to the directory structure of SunOS 4.0.3, system administra- 
/etc/exports tors must now mount /usr/kvm explicitly as an additional entry in the client’s 

/etc/fstab file, and must explicitly export 

/export/exec/kvm/ client kernel arch in the server’s etc/exports. 


Note to System Administrators 


System Administrators: See the System Administration Addenda in the Change 
Pages and Addenda to the Docubox for full explanations of SunOS 4.0.3 system 
administration issues. 


/usr: New and Changed Read about changes to the /usr directory structure in the Change Pages and 

Directories Addenda to the Docubox document set, in the System Administration Addenda. 


New eject Utility The new eject utility supports software ejects for floppy disks on the 

Sun-3/80. Read the e ject ( 1 ) manual page in the Change Pages and 
Addenda to the Docubox document set for a full description of eject features. 


New fdformat Utility The new fdformat utility supports floppy disk formatting on the Sun-3/80. 

Read the fdformat ( 1 ) manual page in the Change Pages and Addenda to 
the Docubox document set for a full description of fdformat features. 


Change to mon/eeprom.h mon/eeprom.h is changed to support the Sun-3/80. 

New Devices MAKE DEV now creates the fd, pp, and ppdiag devices. 

□ fd is the Sun-3/80 floppy drive. 

□ pp is the Sun-3/80 printer port. 

□ ppdiag is a diagnostics special device file. 


The GENERIC The standard GENERIC configuration file has been changed to support new 

Configuration File devices. 
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Performance Tips 


Implementing the following recommendations will not solve every performance 
problem, but many problems can be eliminated by following these suggestions. 


4.1. Routing Workstations with only one Ethernet interface do not need to do dynamic routing 

with in. routed. Instead, you can make them route statically by commenting 
(add a number sign # in column 1) the following lines in /et c/rc. local: 


r 

#if 

[ -f /usr/etc/in.routed ]; 

then 


# 

in.routed; (echo -n 

9 routed') 

>/dev/console 

#fi 



j 


Routing table entries can still be added or modified by the kernel as a result of 
ICMP redirect messages. 

Diskless clients have a route provided automatically by the server. On other 
workstations, a command of this form can be added to rc. local {router is the 
hostname of an IP router—also called a gateway—on the local network); 


/usr/etc/route add default router 1 


This action frees up both the pages used by in. routed and most of the 
memory allocated for routing table entries. 


4.2. Sendmail Receiving mail on a diskless workstation typically causes a significant amount of 

paging, due not only to the creation of sendmail and /bin/mail processes, 
but also to alias resolution and access over the network to the mailbox on the 
server. 

Recommendation : Have each client mount its spool directory via secure NFS, 
change the YP alias map to direct users’ mail to their servers, and do not run 
sendmail on the clients. For example, add a line like the following to each 
client /etc/fstab: 
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- , 

server:/var/spool/mail /var/spool/mail 
nfs rw,bg,hard,intr,secure 0 0 
.___ 


Export / var/spool/mail on the server using the secure option. Do not for¬ 
get to run exportf s. Change or create aliases in /etc/aliases on the YP 
master or provide aliases in this form: 


-. 

user: user@server 

v_ J 


Do this for all users who would otherwise receive mail on the clients, and remake 
the YP alias map with cd /var/yp; make aliases. Comment these lines 
in each client’s /etc/rc. local file as shown below and reboot the clients: 

-- 

#if [ -f /usr/lib/sendmail -a -f /etc/sendmail.cf ]; then 

# (cd /var/spool/mqueue; rm -f nf* If*) 

# /usr/lib/sendmail -bd -qlh; (echo -n ' sendmail')> 
/dev/console 

#fi 

_ 


An interesting and positive side-effect of this change is that a user can receive 
mail even if the client workstation is down. This change is also useful in 
environments where users wish to be able to log in to any machine or a cluster 
and read their mail. 


4.3. Accounting Do not enable process accounting. If accounting is not configured into the kernel 

(options SYSACCT), or the file / var/adm/acct does not exist at boot 
time, accounting is not enabled (see /etc/rc). 


4.4. Do Not Start Workstations typically require only portmap, ypbind, biod (there are four 

Unnecessary Server of them), syslogd, update, inetc, and lpd. Add keyserve if you use 
Processes secure NFS and sendmail if you do not implement the sendmail strategy 

described earlier. 


4.5. Miscellaneous 


□ Do not enable file-system quotas. (By default, quotas are not enabled.) 
Replacing /usr/ucb/quota with /usr/bin/true will prevent possi¬ 
ble delays at login time due to calls to rpc. rquotad on each NFS server 
from which you have a file system mounted. 

□ Use the default SunView background, and do not use retained windows, 
a Do not enable in. rwhod. 
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4.6. Minimizing Kernel 
Size 


1. Do not run the GENERIC kernel except to configure a smaller one! 

2. Edit the kernel configuration file as follows: 

Remove all unnecessary entries from the kernel configuration file. For exam¬ 
ple, the following lines can be removed from DL50 in 
/usr/sys/sun3/conf: 


r 

\ 

options 

CRYPT (unless you use secure NFS) 

pseudo-device 

snit 

pseudo-device 

pf 

pseudo-device 

nbuf 

pseudo-device 

clone 

device 

desO at obio ? csr OxlcOOOO 

v 

— j 


Note: Streams NIT (snit above) is needed by etherfind. To locate 
etherf ind, boot another kernel or run it on the server. 

3. Reduce ‘ ‘maxusers’ ’ to three if it is practical to do so. 



4. Change the following pseudo-device lines from their default values to the 
values shown: 


f - 


> 

pseudo-device 

dtopl 


pseudo-device 

msl 


pseudo-device 

kbl 


V 




5. Reduce streams buffers allocation. 

The default allocation of streams buffers is overly generous. Follow these 
steps to make a kernel with smaller allocations: 

a. Run conf ig using your modified configuration file. 

b. In /usr/share/sys/sun3/A2sRMiLM4ME/param. c, modify the 
default values as shown: 


Because the default kernel (GENERIC) can handle almost any conceivable 
configuration or situation, it contains much more than you are likely to need. 
Unless you will be using one of the preconfigured small kernels, you should fol¬ 
low these recommendations to reduce the size of your kernel and to improve sys¬ 
tem performance (by reducing paging and swapping). 



Revision A of 7 July 1989, Part. No. 800-3815-11 








44 SunOS 4.0.3 Release Manual 


#define 

NBLK2048 

4 

#define 

NBLK1024 

4 

#define 

NBLK512 

4 

#define 

NBLK2 5 6 

16 

#define 

NBLK128 

64 

#define 

NBLK64 

64 

#define 

NBLK16 

64 

#define 

NBLK4 

64 


#define 

NSTREAM 

20 

#define 

NMUXLINK 

37 

#define 

NSTREVENT 

64 


Larger allocations may be required in some environments. In some cir¬ 
cumstances, running out of mblocks can deadlock the system. Check 
your usage with ne t s t a t -m. 

c. Run make. 

6 . Ethernet buffers 

If you have an le Ethernet interface (Sun-3/50, -3/60, -3/80, or SPARCsta- 
tion 330) reduce the number of Ethernet buffers from the default values: 

. 

# adb s-w vmunix 
le_nrmdp2?W 3 
le_nrbugs?W A 

$q 

# 

V :..:.. : •: - ■ ■ : :V: : ■ ■■ ■ - ■ -:: : ■ ■ i’ ■ ■ : ■- ■- V.-'-.'.•' V ' : : : '' ■' ■■■':: - V : '■ v : : :■ _-_ ...... J 

If you have an ie Ethernet interface: 


-_____ — _______ -____ -—V 

# adb s-w vmunix 
ie_tbugs?W 1 
ie_rbds?W 6 
ie_rfds?W 5 
ie_rbufs?W 9 

$q 

# 

_____ 


1. UFS (UNIX File System) buffers: 

If you have a disk, you can reduce the number of buffers allocated to the 
UFS buffer cache: 
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/ ---~ 

# adb -w vmunix 


: .. ---~\ 

nbuf ?W 6 



$q 



v __ 


. J 


#sun 
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5.1. The Sun-3/80 Desktop 
Workstation 


Floppy for the Sun-3/80 


5.2. Sun-3/470 Deskside 
Workstation and 
Sun-3/480 Server 


Ijl'MWW 


The Sun-3/80 and Sun-3/470, Sun-3/480 

Workstations and Servers 

The Sun-3/80 is a low-cost desktop system featuring optional integrated mass 
storage and an optional floppy disk. Based on a 20 MHz Motorola 68030 proces¬ 
sor with a base configuration of 4 megabytes of dynamic random access memory 
(DRAM), the Sun-3/80 is binary-compatible with most applications based on 
other Sun-3 products. This compact system has a wide variety of configurations. 

The Sun-3/80 has many attractive features for users preferring the familiar 680*0 
architecture: 

□ Compact packaging 

□ Motorola 68882 floating point unit (standard) 

□ Optional integrated floppy disk 

□ Optional integrated 3-1/2" SCSI hard disks 

□ Many frame buffer and graphics accelerator options 

□ External mass storage expansion capability 


SunOS 4.0.3 supports the 3-1/2" flexible diskette (floppy disk) drive used in the 
Sun-3/80 Workstation. This floppy is an industry standard, non-SCSI device 
with a 1.44 megabyte capacity. 

You use the floppy in the same ways as you use other disks. For example, the 
floppy disk can contain a UNIX file system and can be mounted like any other 
disk partition. In addition, floppy disks can be used to boot the system and to 
copy application software from diskette to your system. SunOS knows the 
floppy as /dev/fdO. 


The Sun-3/470 and Sun-3/480 are based on the 33 MHz Motorola 68030 proces¬ 
sor. Both systems provide many important features and offer a variety of expan¬ 
sion options: 

□ 33 MHz Motorola 68882 floating point unit (standard) 

□ Optional high-performance floating point accelerators 

□ Many frame buffer and graphics accelerator options 
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Cartridges for the 150- 
megabyte 1/4" tape drive 


5.3. Differences Between 
Sun-3 (68020-based) 
and Sun-3x (68030- 
based) Workstations 


□ 60- and 150-megabyte 1/4" tape drives 

□ 1/2" 6250/1600 bpi tape drive 

a Up to 1.3 gigabytes of SCSI disk storage 

□ Any combination of 4 SMD-4 controllers and 8 SMD disk drives on the 
Sun-3/470 

□ Any combination of 4 SMD-4 controllers and 16 SMD disk drives on the 
Sun-3/480 

The 150-megabyte tape drive can write to the 3M-DC6150 tape cartridge 
(formerly the 3M-DC600XTD tape cartridge), available as Sun part number 
370-1203-01. 

Tapes written on the 60-megabyte tape drive, such as the 3M-DC300XL/P tape 
cartridge (Sun part number 370-0543) and DEI Series II Silver (Sun part number 
370-0543) tape cartridge, can be read on the 150-megabyte tape drive. Failure 
to use the proper tape for the specified tape drives, or use of any other tape 
cartridges, is not supported by Sun Microsystems. 

To find the type of tape drive installed on your system, load a tape into the drive 
and enter the following command, replacing NUM with the number of your tape 
device (for example, /dev/rst8): 

mt -f /dev/rst NUM status 

The following message displays when you have a 150-megabyte 1/4" tape drive: 

Archive QIC-150 tape drive: 

sense key(0x0)= no sense residual= 0 retries= 0 
file no= 0 block no= 0 


The new 68030-based, Sun-3x, computers (Sun-3/80, Sun-3/470, and Sun-3/480) 
are members of the Sun-3 family and run Sun-3 user-level applications 
unchanged. However, while the Sun-3 uses the MC68020 and the Sun MMU, 
the Sun-3x uses the MC68030 with an on-chip MMU. This difference necessi¬ 
tates a unique kernel for each of the two system architectures. 

For detailed information about the MC68020, see the MC68020 User’s Manual, 
MC68020UM/AD Rev 1 and the Sun-3 Architecture Manual. To understand the 
MC68030, read the MC68030 User’s Manual, MC68030UM/AD Rev 1. 

Because the 68020 and 68030 run the same application binaries, they are said to 
have a sun3 application architecture. Because they require different kernel- 
dependent code, however, their kernel architecture is different: the 68020 has a 
sun3 kernel architecture, while the 68030 has a sun3x kernel architecture. 

The application architecture is displayed by arch, while the kernel architecture 
is displayed by arch -k. See the arch (1) manual page for details. 


Cartridges for the 150- 
megabyte 1/4" tape drive 


5.3. Differences Between 
Sun-3 (68020-based) 
and Sun-3x (68030- 
based) Workstations 
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User programs 


Drivers 


Other Differences 


Following is a list of differences between the Sun-3 and Sun-3x architectures that 
can require you to relink, recompile, or rewrite a program. 


□ Relink, or recompile and relink, programs that read or write kernel data 
structures. Relink programs that use the libkvm library. Recompile pro¬ 
grams that depend on kernel data structure offsets or sizes. 

□ Programs using the 68020 callmand rtm instructions do not work on 
the 68030 because these instructions do not exist on the 68030. This should 
not cause problems, as the compilers never generate these instructions. 

□ Re-port programs that assume that the user stack starts at a particular loca¬ 
tion. On a Sun-3x, the user stack starts at OxeOOOOOOO. On a Sun-3, the user 
stack starts at OxOfOOOOOO. In particular, programs assuming the stack 
pointer is “positive” will not work. 

□ Recompile drivers accessing kernel data structures (such as the user area and 
the process table). The offsets of a field in these structures can be different 
between the Sun-3 and the Sun-3x. 

□ Rewrite drivers that “know” about page table format, such as some graphics 
drivers, to use the 68030 page table format. 

□ Rewrite drivers with hard-coded kernel addresses to use the correct 
addresses on the Sun-3x architecture. 

□ Change drivers that access the system enable register, such as some graphics 
drivers. This is a short on the Sun-3x architecture rather than a char. 

The following two items apply to the Sun-3/470 and Sun-3/480 only: 

□ Insert delays for some drivers (for example, the DES driver) to wait for 
hardware to be ready. The Sun-3/470 and Sun-3/480 machines need these 
delays because they are faster than other Sun-3 machines. 

□ For improved performance, rewrite disk and Ethernet drivers (and possibly 
others) to take advantage of the I/O cache. To do this, maik the buffer with 
the B_lOCACHE flag in the strategy routine if the buffer is aligned properly 
(16 bytes), and turn this flag off in the interrupt routine when the I/O 
completes. 


The kernel, kadb, the boot blocks, the tf tpboot program for Sun-3x 
clients, and libkvm are different between the 68020 and the 68030. Also, the 
arch -k command prints sun3x on a Sun-3x machine and sun3onaSun-3 
machine. 
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Compiling Kernel-Dependent The following techniques are recommended when the same kernel-dependent 
Code source code is to be compiled for both the sun3 and sun3x targets. 

□ Use the enhancements to arch (1) and make (1) in your makefile to 
define either “sun3” or “sun3x.” These ar ch (1) and make (1) enhance¬ 
ments are new with SunOS 4.0.3, and the following example does not work 
with the arch (1) and make (1) commands from previous releases. 


- . 

ARCH:sh = arch -k 
CPPOPTS= -D$(ARCH) 

CFLAGS= $(CPPOPTS) 

_ 


□ As appropriate, use #if def sun3 and #if def sun3x in your code. 

- \ 

#if defined(sun3) || defined(sun3x) 
code identical for the Sun-3 and the Sun-3x 
tendif sun3 || sun3x 

#ifdef sun3 

code for the Sun-3 only 

tendif 

tifdef sun3x 

code for the Sun-3x only 

tendif 

— 


Note that you must explicitly ask for the definition of C pre-processor architec¬ 
ture symbols like sun3 and sun3x, invoking the compiler with 
cc -Dsun3 or cc -Dsun3x. These symbols are not defined by default. 

Also, while -sun3 is a legal cc command-line option for both the 68020-based 
Sun-3 and the 68030-based Sun-3, -sun3x is not a legal cc command-line 
option. 
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SPARCsystem 300 Deskside 
Workstations and Servers 


6.1. SPARCsystem 300 
Overview 


6.2. SPARCsystem 330 



Cartridges for the 150- 
megabyte 1/4" tape drive 


The SPARCsystem 300 is a family of high-performance computer systems based 
on the 25 MHz Reduced Instruction Set Computer (RISC) processor, SPARC 
(Scalar Processor ARChitecture). The SPARCsystem 300 packaging options and 
expansion capabilities meet a diverse set of computing needs. 

The SPARCsystem 330 compact deskside package offers integrated mass 
storage and backup capabilities. Features of the SPARCsystem 330 include the 
following. 

□ High-performance floating point unit (standard) 

□ Many frame buffer and graphics accelerator options 

□ Three 9U x 400mm VME slots 

□ Two 6U x 160mm VME slots 

□ 150-megabyte 1/4" tape drive 

□ Up to 1.3 gigabytes of SCSI disk storage 

The 150-megabyte tape drive can write to the 3M-DC6150 tape cartridge 
(formerly the 3M-DC600XTD tape cartridge), available as Sun part number 
370-1203-01. 

Tapes written on the 60-megabyte tape drive, such as the 3M-DC300XL/P tape 
cartridge (Sun part number 370-0543) and DEI Series II Silver (Sun part number 
370-0543) tape cartridge, can be read on the 150-megabyte tape drive. Failure 
to use the proper tape for the specified tape drives, or use of any other tape 
cartridges, is not supported by Sun Microsystems. 

To find the type of tape drive installed on your system, load a tape into the drive 
and enter the following command, replacing NUM with the number of your tape 
device (forexample, /dev/rst8): 

mt -f /dev/rst NUM status 


6.1. SPARCsystem 300 
Overview 


6.2. SPARCsystem 330 



Cartridges for the 150- 
megabyte 1/4" tape drive 
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The following message displays when you have a 150-megabyte 1/4" tape drive: 


Archive QIC-150 tape drive: 

A 

sense key(0x0)= no sense residual= 0 

file no= 0 block no= 0 

retries= 0 

il —:- 1 . iS. . ... ._ 

j 
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GPSI Enhancements 


7 . 1 . 




GPSI Features 


This newest release of GPSI (Graphics Processor Software Interface) microcode 
adds the following new features to the Sun graphics processor family—the 
GP2/CG9, GP2/CG5, and GP+/GB/CG3 graphics board sets. 

1. Picking 

2. Matrix Stack 

3. Markers 

4. Z-Buffered Vectors 

5. Depth-Cued Vectors 

6. RGB (Red-Green-Blue) Color Model Support, including Gouraud-shaded, 
RGB-interpolated polygons, and shading of vectors. 

7. Lighting 

8. Stroke Text 

The first five items are new GP 1_ GPSI commands for the GP2 and GP+ graph¬ 
ics accelerator boards. They are inoperative on the older GP because of micro¬ 
code space limitations, but will nevertheless run GPSI applications using the new 
commands on the GP without problems. 

Items 6 and 7 extend the GPSI interface to support true color : color is specified 
and processed as RGB (red-green-blue) triplets. The new RGB vector and 
polygon support makes the GP2 a “true color” graphics engine and provides the 
foundation for advanced shading and lighting. For compatibility, the “index 
color” GPSI commands are still available. Items 6,7, and 8 are provided only 
for the GP2 (not for the GP or the GP+); to make this clear, these GPSI com¬ 
mands begin with GP2_ instead of with GP 1_. 

Lighting support is now provided by the GP2 as follows: 

□ Colored ambient light 

□ Eight independent colored light sources 

□ Diffuse light reflection model 

□ Infinitely distant directional light sources 
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• 

□ Back facing polygon rejection 

o Back face lighting 

□ Specular reflection 

In addition, the GP2 now supports the downloading of stroke fonts to provide 
fast stroke text drawing speeds. 

These new GPSI microcode enhancements are supported on the new 24-bit, 
GP2/CG9 graphics accelerator board set, as well as the existing GP2/CG5 board 
set and, with exceptions as noted, the GP+/GB/CG3. 

7.2. Software Integration 

The GPSI microcode is integrated into SunOS 4.0.3, and is found in the 
/usr/lib directory. 

Colorcube 

To use the new RGB GPSI commands with the CG5 8-bit color board, load the 
CG5 color map with a 5-9-5 color cube (5 levels of red, 9 levels of green, and 5 
levels of blue). 

This 5-9-5 color map is in the header file 
/usr/include/sunwindow/cms_colorcube.h. 

Programmer’s Guide 

An addendum to the GPSI programmer’s guide, GPSI Programmer’s Guide 
Addendum (800-3616-01), is available. 
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CG6 Graphics Accelerator Board 

The CG6 board accelerates the performance of many 2D and 3D graphics appli¬ 
cations. This P4 color frame buffer uses two ASICs to accelerate production of 
eight-bit color images. 

8.1. Supported 

Workstations 

The CG6 graphics accelerator plugs into the P4 bus on these Sun workstations: 
3/60, 3/80, 3/470, and SPARCsystem 330. To install the board, follow the 
instructions in the hardware installation manual that accompanies the board. 

8.2. Software Interface to 
CG6 

The software that supports CG6 functionality is included in SunOS 4.0.3. 

Supported Graphics 
Application Software 

The following four types of graphics libraries are available for Sun workstations 
equipped with CG6 boards. 

□ PixWin 

□ Pixrect 

o SunGKS 

□ SunPHIGS 

Note that PixWin and Pixrect are bundled libraries, while SunGKS and Sun¬ 
PHIGS are not. 

Compatibility 

When upgrading applications to the CG6, the following compatibility considera¬ 
tions apply. 

□ Applications prepared with CGI/CORE are not supported on the CG6. 

□ Most statically linked applications run, but are not accelerated, on the CG6. 

□ Dynamically linked (or manually relinked) applications are accelerated by 
the CG6. 

□ Recoding is necessary in the following cases: 

□ Where overlays are required or expected by the application. 

□ Where the application depends on the existence of PixWin or Pixrect 
internal data structures. 
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Documentation 


□ Where the application is written in CGI or CORE. 

For more information on performance tuning applications for the CG6, refer to 
the GX Technical Note. 

The following manuals are general references on CG6-related topics. 

□ The SunView Programmer’s Guide, Part Number 800-1783-10, and the 
SunView System Programmer’s Guide, Part Number 800-1784-10 

□ The Pixrect Reference Manual, Part Number 800-1785-10 

□ The SunPHIGS Reference Manual, Part Number 800-2475-01, 
and the SunPHIGS Programming Guide, Part Number 800-2476-01 

□ The GX Technical Notes 

□ The SunGKS Reference Manual, Part Number 800-3560-01 

□ The SunGKS Software Installation Guide, Part Number 800-3561-01 

□ Read This First for the SunGKS Installation Guide, 

Part Number 800-3652-01 
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9.1. Keyboard Features 


Type-4 Advantages 


Changes for the Type-4 


Unsupported Features 



Type-4 Keyboard 


Type-4 keyboards are the new standard for Sun workstations. SunOS releases 
4.0 through 4.0.3 allow you to use the Type-4 keyboard as the earlier Type-3 
keyboard was used. All earlier Sun keyboards are supported, also. 


Current advantages of the Type-4 keyboard over the Type-3 keyboard are: 

□ The Type-4 keyboard has three more software-programmable function keys 
than the Type-3 keyboard. 

□ The Type-4 keyboard passes standards for electronic emissions in several 
countries. 

The I Left I and 1 Right 1 keys on the bottom row of the older Type-3 keyboard now 
show diamond symbols instead of the words Left and Right. Key function for 
these “meta” keys is unchanged. 


Many features of the Type-4 keyboard will be supported in coming SunOS 
releases. New keys on the the Type-4 keyboard that are not yet supported under 
SunView are: 

□ I Help 1 on the left keypad 

o [ Compose 1 . ("AID , and I Alt Graph 1 on the bottom keyboard row. 

□ All keys on the right (numeric) keypad. 

Future releases will also support the “Key Lights” (also called LED) panel 
above the right keypad. 

Finally, the setkeys utility (/usr/old/setkeys) does not work with the 
Type-4 keyboard and is being phased out. Use the input function in the 
def aultsedit program in place of setkeys. 
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10.1. 24-Bit Color Frame Buffer Board, CG8 
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24-Bit-Color Support 


10.1. 24-Bit Color Frame 
Buffer Board, CG8 



The new 24-bit frame buffer, the CG8, uses 24-bit-deep pixels to produce true- 
color images. The CG8 color lookup table allows for color adjustments, such as 
gamma correction, on the standard 900x1152 resolution display. 

The monochrome overlay plane and enable plane allow displaying either the 
color or the monochrome plane on a pixel-by-pixel basis. 

SunOS 4.0.3 provides a software driver, and code for enhancements to Pixrects 
and SunView 1 that take advantage of 24-bit color. The code changes are docu¬ 
mented in the Pixrect Reference Manual and in the SunView 1 Programmer’s 
Guide. See also the document set Change Pages and Addenda for the Docubox 
for release notes on 24-bit-color support. 

Note: Eight-bit indexed color applications must be modified to run with the 24- 
bit color frame buffer. Unmodified applications will run, but will display images 
incorrectly—most likely, with an all-red screen. 


10.1. 24-Bit Color Frame 
Buffer Board, CG8 
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SunDials 


11.1. SunDials SunDials is an image-manipulation input device for Sun-3, Sun-4, and 386i 

workstations, using an RS-232 serial interface. The desk-top dialbox is compact, 
measuring 8.63"x5"xl.l5". 

The dials can be programmed to change colors and manipulate images. Image 
manipulation such as scaling, translating, rotating, and zooming is essential for 
many CAD applications. 

SunView directs SunDials input to the process owning the window (where the 
cursor is located). SunDials extends the interactivity of the display controller 
beyond the current capabilities of a mouse or digitizing tablet. 

The SunDials device driver is integrated into the GENERIC kernel. No optional 
software or kernel reconfiguration is required, but kernel reconfiguration is 
recommended for optimal performance. 
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Floating-Point Unit, FPU2 
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FPU2 Floating-Point Unit 


Floating-Point Unit, FPU2 



The FPU2 is a new floating-point hardware unit for the Sun-4/110,150,260, and 
280. The FPU2 has a TI 8847 floating-point unit with an LSI Logic controller 
chip. 

SunOS 4.0/Fortran 1.1 programs can run unaltered after you install the FPU2. 

The inline expansion template file /usr/lib/sqrt. il, included on this 
tape, may optionally be used to improve performance of Sun-4 FPU2 on prob¬ 
lems that perform many square root operations. The inline expansion templates 
replace calls to sqrt subroutines with hardware instructions. Executables 
created with these templates may run slowly on older Sun-4s with the Weitek 
1164/5 floating-point hardware, which has no sqrt instructions. 

Use the inline expansion template by recompiling with either of these 
commands: 

-N 

f77 -04 source.f /usr/lib/sqrt.il /usr/lib/libm.il 

or 

cc -04 source.c /usr/lib/sqrt.il /usr/lib/libm.il -lm 

V_ J 

For more information on inline expansion templates, see the inline (1) 
manual page and the Floating-Point Programmer’s Guide accompanying 
SunOS 4.0. 

A new utility program searches for the FPU2. This utility, f puversion4 ( 8 ), 
determines whether the high-performance floating point components are installed 
on the system CPU. Detecting the presence of the FPU2, the diagnostic prints a 
confirming message: 
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FPA+ 


13.1. Description The FPA+ is a high-performance floating point accelerator for use in the 

Sun-3/470 and Sun-3/480 systems. 

While it is object-code compatible with applications written for the Sun-3 FPA, 
this new unit performs floating point operations faster than the FPA because it 
runs at the CPU speed of 33 MHz and uses fewer cycles for each operation. 
While the FPA occupies an entire 9U slot, the FPA+ is a daughter board that 
attaches directly to the CPU board, and therefore occupies no additional slots. 

Both FPA+ and FPA microcode are supplied with this release. The 
f pa_download (8) command is changed to pick up the appropriate 
version. 
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High-Performance SMD Disk Drive 

and Controller 

14.1. 688-Megabyte SMD 
Disk Drive 

This is a high-capacity, 8" disk drive based on Winchester technology. Called 
the Storage Pedestal Upgrade Drive (SPUD), the drive has an unformatted capa¬ 
city of 700 megabytes and formats to 688 megabytes. This is 2.5 times greater 
than the existing 8" disk drive in the Sun Mass Storage Pedestal, although it 
occupies the same physical space. 

The SPUD also improves on the access time, cost per megabyte of storage, and 
reliability of the current 8" drive. Performance improvement results in part from 
SMD-4, the new SMD controller. 

14.2. VME/SMD Disk 
Controller 

This high-performance VME/SMD disk controller has a 128-kilobyte read-ahead 
cache and a pipelined bus DMA architecture. Each controller supports up to four 
of one type of the following disk drives: 

□ 8" 688-megabyte disk drive 

□ 10" 575-megabyte disk drive 

□ 9" 892-megabyte disk drive 

The disk controller also supports the following functions: 

□ Overlapped seeks 

□ Read and write optimizations 


#sun 

\r microsystems 
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15 

Bug Fixes Since 4.0 


15.1. Introduction This chapter describes the bugs fixed since the release of SunOS 4.0.1 including 

4.0.3 

The bug-fix descriptions are categorized as follows: 

Graphics 

SunOS 

Kernel 

SCSI drivers 

Serial drivers 

Network 

Compiler 

Debugger 

Utilities 

System Administration 

SunView 

Suninstall 


15.2. Graphics Bugs Fixed The following graphics bugs have been fixed. 


CG6 graphics accelerator 


The CG6 graphics accelerator is supplied with a patch tape. 


System Hung When GP2 GP2 could hang the system when trying to render some polygons. 

Rendered Polygons 


Extra Pixels Affected Texturing The GP2 (PHIGS microcode) drew texture lines that appeared to be incorrect. 

There were additional pixels at each break in the texturing. 
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Incorrect Vector Identified for 
Picking 


Overlay Colormap 


_XF_LINE_FLT Left 
Extra Pixel 

clip_f lag Error on 
Sun-3/260 


Polygons with Many 
Nonhorizontal Edges 


SunPHIGS Programs Died 


GP+ Drew Textured Polygons 
with PICK_NODRAW Set 


Auto Arrays in 
pr_texvec. c with 
Same Name 


Invisible Cursor with CG4 
Frame Buffer 


cf ramedemo Dumped Core 


When lines (usually diagonal) were transformed through GP2 using 
_PROC_LINE_FLT_3D, bit 15 of clip_f lag was not set if the vector was 
totally invisible. This caused an incorrect vector to be identified for picking in 
SunPHIGS. 


The colormap of a one-bit-deep frame buffer can now be changed. 


XF_L I NE_F LT could leave an extra pixel outside the clipping viewport. 


When running GP2 on a Sun-3/260, there could be an error in clip_f lag 
when you used the command GP1_PR0C_LINE_FLT_3D. 


If you used GP1_XF_PG0N_INT_2D to draw a polygon with 370 or more 
nonhorizontal edges, the GP2 could hang the system. 


SunPHIGS programs died (typically, receiving SIGXCPU signal while drawing 
SOLID-filled fill areas) on a Sun-4/150. 


The GP+ rendered textured polygons even though the pick mode flag was set to 
PICK_NODRAW(2). This has been fixed so that, in pick mode, primitives are 
analyzed for picking, but not drawn. 


Several functions in pr_texvec. c declared auto arrays named segarray, 
which could be used after the declaring functions returned. The problem was 
noticed when a program using pr_line looped indefinitely in bres_vert 
after compiling the (SPARC) Pixrect library -02. (The stack layout was 
sufficiently rearranged to manifest the problem.) 


When sunt ools displayed an alert box, the cursor was invisible on any 
machine with a CG4 frame buffer. 


The cf ramedemo program compiled, but dumped core when it ran. 


Incorrect Vector Identified for 
Picking 


Overlay Colormap 


_XF_LINE_FLT Left 
Extra Pixel 

clip_f lag Error on 
Sun-3/260 


Polygons with Many 
Nonhorizontal Edges 


SunPHIGS Programs Died 


GP+ Drew Textured Polygons 
with PICK_NODRAW Set 


Auto Arrays in 
pr_texvec. c with 
Same Name 


Invisible Cursor with CG4 
Frame Buffer 


cf ramedemo Dumped Core 
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Incorrectly Drawn Cursor in Because of an initially faulty CG8 pixrect implementation, the cursor was 

suntools Reverse Video not drawn in reverse video. The cg8_colormap. c file has been changed to 

fix this bug. 


Missing CG8 Driver Functions The cgeight driver functions were missing from the stubs . c file, causing 

undefined symbols messages in some configurations. Adding cgeight 
driver functions to the stubs. c file fixed this bug. 


Cursor Was Drawn Wrong in sunview uses the side-effect of the pixrect library function 

Reverse Video with CG8 pr_put colormap to decide if the screen is in reverse video. It expects the 

kernel to have the same function with the same side-effect to draw the cursor 
correctly. CG8 pixrect implementation initially did not do this. This is fixed. 


pr_polyline Destroyed GP2 The pixrect code has been changed to reset the line type after polymarker 
Context Line Texture primitives. 


15.3. SunOS Bugs Fixed This section describes bug fixes in the SunOS. Those applicable to the operating 

system are listed first. 

/usr/ucb/w The w program did not display processes on the console. 

f ilemerge The f ilemerge program was inadvertently left out of SunOS 4.0 (it should 

have been moved to /usr/old). The program is now in place, and the 4.0 
SunOS Reference Manual contains a manual page, oldf ilemerge (1). 


fpa_download fpa_download, which runs from rc. local at boot time, now outputs data 

to indicate that it is downloading the FPA or FPA+ programs. The rc. local 
file is changed with this fix, and the fix file is stored where all clients of a server 
have access to it. Read and follow the installation instructions carefully to 
prevent overwriting customized rc. local files. 


ldcore When compiling a set of . o files under SunOS 4.0 and using two Ids to link 

the programs, the second Id dumped core. The problem was associated with 
overflowing the hard limit for the number of symbols in one . o file. This bug 
is fixed. 
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libc Execution of setlogmask (3) resulted in a core dump and segmentation 

fault; calling syslog(3) before openlog(3) dumped core; yellow-pages 
support for the resolver (nameserver) did not work; and f put failed when there 
was more than one newline on line-buffered streams. 

This bug was introduced when many library routines were changed. A number 
of libc (and other) files are now changed, and special rebuild and installation 
instructions are given in the README file of the 4.0.1 bugfix tape. These bugs 
are fixed. 


liblwp, -llwp Programs did not link with the lightweight process library; Sun-2 and Sun-3 link 

attempts caused an error message, REGOFFSET undefined; Sun-4 attempts 
produced SP_OFFSET, pc_OFFSET, and others. This bug is fixed. 


Misleading syslog (3) According to the manual page, “If special processing is needed, openlog () 

Manual Page can be called to initialize the log file.” In fact, openlog (3) must be called 

before syslog (3) is used or logging will not occur. 


Daylight Savings Time Daylight savings time was handled incorrectly for the U.K., Australia, and parts 

Incorrectly Handled of Europe. This has been fixed to match the latest EEC agreement. 


386i Security Hole The -h feature of ypset could breach yp domain security to allow root access. 

15.4. Kernel Bugs Fixed This section describes bug fixes in the SunOS kernel code. 


nsops argument If you passed a large nsops argument to the semop system call on a system 

with auditing configured in, the system would crash with “panic: rmalloc.” 


kernel in single user mode Making a kernel in single user mode on a Sun-4 caused a core dump error. 


System with SCSI-3 (si) host Incorrect blocking factors to SCSI tape on system with SCSI-3 (si) host 

adapter adapters caused the kernel to continuously print messages. 


xon/xoff flow control If a “tandem” connection (where the system sends xon/xoff flow control as its 

input buffers fill) was closed while the ldterm module had marked the incom¬ 
ing stream as “full” and last sent an m_stopi streams message, the correspond¬ 
ing m_starti message was not sent and the remote device was prevented from 
sending data to subsequent sessions. 

If reversed-flow control is enabled with stty ixof f so that the system sent 
xon/xoff characters to prevent its input buffers from overflowing, and the port 
was closed between sending an XOFF and an xon, an xon character was not 
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generated, probably leaving the remote device in an undesirable state. 


ALM-2 If a nonblocking open of an incoming ALM-2 port failed due to an outgoing con¬ 

nection in progress, the processor’s interrupt priority was not properly restored 
inside the device open routine, mcpopen () raised processor priority to 4 on 
entry. Under some conditions, it returned without lowering priority back to zero. 

mcpa_drain () While draining the ring buffers for the low-level interrupt response routines, 

mcpa_drain () manipulated the processor’s interrupt priority improperly. 

ALM-2 sometimes sent incomplete streams messages. 


ge 11 y If a user started a background process on a modem port and hung up the phone, 

the system was unable to start a new getty on that port until the background 
job completed; every five minutes, getty reported an I/O Error on the port. 

Diskless Client Boot Panic While booting a diskless machine under 4.0, a sleep occurred that caused the 

system to panic. 


Driver Mapping Requests The kernel routines in Sun/V/machdep. c use a locally defined constant 

MAXMPHYS to limit the maximum DVMA window for raw device I/O. If a 
driver requested a larger mapping, the kernel would panic. 


Pseudo-ttys Could Hang c sh Depending on the setting of shell environment variables, a pseudo-tty could 

or shelltool cause a shell (csh) or shelltool to exit or hang. Rebooting the system 

returned the pty to its normal state. This has been fixed. 


Diskless Clients Froze When When booting multiple diskless clients simultaneously from a 3/280 server, some 
Booted Simultaneously clients froze. This is no longer the case. 


Bus Error Running a program that used TIOCOUTQ ioctl caused a “panic: bus error” 

under SunOS 4.0. The tty. c program has been changed so this no longer 
happens. 


KERNELBASE and SYSBASE KERNELBASE and SYSBASE definitions, along with a problem in 
Definitions buscheck (), precluded mapping in buffers that were allocated in kernel 

data/bss. 
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Missing Initialization in 
Socket Code 

Vnode for Console Missing 

exec Failures May Not Clean 
Up Properly 

Interrupt Priorities on Sun-4s 
Tapemaster Driver 
Calls Improperly Nested 

st Driver 

Drivers Test Returns from 
kmem_alloc 

sysdiag Test Hangs: 

uucico 

NIT STREAMS Buffering 
Module 

Multiple Contiguous Writes 
Hung Bus 


The send-related kernel socket code was missing an initialization. This has been 
fixed. 


Performing the TIOCCONS ioctl on the controller device of a pty could panic 
the kernel. 


In some cases, exec failures did not clean up properly. In particular, the path¬ 
name buffer allocated for the initial lookup was not freed, and the vnode for the 
file was not released. 


On Sun-4s, the system could hang due to problems with interrupt priorities. 

The Tapemaster driver caused a system panic when tar or dump was used. 

The exit routines at the end of the runtime code used by boot to save the caller’s 
stack environment did not nest calls. 

The st driver did not behave as documented in st (4). When read () sees a 
tape mark, it does not proceed to the next tape file. 


Because kmem_alloc no longer panics if it can’t return memory, drivers now 
must test returns from kmem_alloc. 

The tapetop 1/4" tape test in sysdiag hung at start-up. 

A system panic sometimes occurred due to a data fault at location stropen+dc 
when running the user program uucico. 

The NIT STREAMS buffering module, nit_bug (4m), failed to collect mes¬ 
sages into chunks that arrived on its read queue. Instead, each message was 
passed to its upstream neighbor upon receipt. 

Multiple contiguous writes to two SCSI disks on the same controller could hang 
the bus. 


Missing Initialization in 
Socket Code 

Vnode for Console Missing 

exec Failures May Not Clean 
Up Properly 

Interrupt Priorities on Sun-4s 
Tapemaster Driver 
Calls Improperly Nested 

st Driver 

Drivers Test Returns from 
kmem_alloc 

sysdiag Test Hangs: 

uucico 

NIT STREAMS Buffering 
Module 

Multiple Contiguous Writes 
Hung Bus 
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Null mblok Dereferenced 
Reselect Interrupt Recovery 

VPC-2200 Device Driver 
Read and Write System Calls 

System Crashed when Exiting 
Mailtool 

mknod on Customized Kernel 
Caused Panic 

Inverted Test in 
makenfsnode 

Adaptec ACB-4000 Controllers 

File Position Reported 
Incorrectly 

Login Ports 

kadb Hung When Booted on 
4/110 

asrtfail System Panic 


The wscon driver could dereference a null mblk. 

For certain configurations, a message did not indicate that a hardware problem 
involving a lost reselect interrupt had been recovered in software. 

The device driver for the VPC-2200 did not work correctly. 

Read and write system calls did not always work on a Sun-4 when the buffer was 
in the VME space (usually obtained via an mmap () call). 


The system could crash when exiting Mailtool. 


Executing mknod on a customized kernel could cause a panic: bus 
error: if size routines in the xy and sd drivers deferenced pointers to 
structures for which memory had not been allocated at configuration time. 

In makenf snode (), one of the tests that determines whether to reuse a cached 
mode or to create a new one was inverted. Under some conditions, this caused 
the kernel heap to grow without bound. 

If you formatted an st-506 disk controlled by an Adaptec ACB-4000 controller, 
the operation failed with a mode select error. 

The st driver did not report the correct file position if f sf failed when 
skipping files. 

If /dev/console and /dev/ttya were both enabled as login ports, a panic 
crash occurred. 

The kernel debugger, kadb, hung when booted on a Sun-4/110. 


The Sun-2, Sun-3, and Sun-4 kernels were changed to correct the system panel 
and panic: assertion failed: message. Becauseuprintf also 
caused this message when exiting sysdiag, the kernel now checks for a stream 
pointer before attempting to print to the controlling terminal of a process. 


Null mblok Dereferenced 
Reselect Interrupt Recovery 

VPC-2200 Device Driver 
Read and Write System Calls 

System Crashed when Exiting 
Mailtool 

mknod on Customized Kernel 
Caused Panic 

Inverted Test in 
makenfsnode 

Adaptec ACB-4000 Controllers 

File Position Reported 
Incorrectly 

Login Ports 

kadb Hung When Booted on 
4/110 

asrtfail System Panic 
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Watchdog Reset with Bus Error 
on 4/110 

On 4/110 systems running 4.0, bus errors that normally kill applications caused a 
watchdog reset instead. The following code, compiled with ‘-g’ and executed on 
a 4/110 running 4.0, causes the system to die with a watchdog reset: 

r > 

main() 

{ 

double *v ; 
int i ; 

i = 1382236159 ; 

v = malloc(120*sizeof(double)); 
printf (”%d,%g0, i,v[i]); 

} 

Guards Added to Header Files 
in /usr/include 

Guards have been added to the header files in /usr/include, with these 
exceptions: 

/usr/include /til 
/usr/include/pascal 
/usr/include/pixrect 
/usr/include/suntool 
/usr/include/sunview 
/usr/include/sunwindow 

Kernel Prints Fault Information 
Carefully, Avoids Watchdog 

Reset 

The kernel did not always dump meaningful information as it died from a bus 
error. To aid developers, showregs () is reworked to correct information 
about a crash. 

Interrupt Loss from 7053 Under 
Heavy I/O Caused System to 

Hang 

On the Sun-3 and Sun-4, spurious interrupts or invalid interrupt vectors hung the 
system and stopped I/O to the 7053 disk. The only recovery was to reboot the 
system. A watchdog mechanism was added to correct this bug. 

Kernel Crashed when Syncloop 

Ran on Asynchronous MCP 

Port 

The kernel driver code was changed so that open routines return an error if the 
mcp. ops pointer is already set to another protocol. 

ipc 

A kernel crash occurred with STREAMS NIT and an IPC board. There may have 
been corruption of stream buffers and control information when STREAMS NIT 
was used. This was observed only on the IPC memory Ethernet driver. The bug 
is fixed. 
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On NFS, Vnode Unrecognized 
as umount Directory 

The umount system call follows the link and overshoots the mount point. 

The automounter compensates for this by responding as a directory rather than as 
a symbolic link. The vnode type is assigned at mount time and assumed not to 
change. 

A code change now convinces the kernel that this mount point is a directory. 

kbdriver 

Kernels configured with some non-Sun keyboard drivers did not work with 
kadb even when a Sun keyboard was used. An I Ll-A ] abort that should have 
dropped into kadb instead dropped into the PROM monitor, bypassing kadb. 
This is fixed. 

lgkernel 

Kernels larger than one megabyte did not work. Kernels worked when built 
smaller than OxfcOOO, while the same sources built on a kernel larger than 
OxfcOOO did not. 

Kernel Restarts Instruction that 
Caused Segmentation Fault 

The kernel did not restart the instruction that caused the segmentation violation 
(SIGSEGV) when rlimit. rlim_cur was upped after a stack overflow. Now 
the processor state is saved when signals occur so that returning from a signal 
handler causes the processor to continue correctly. 

pObr, pOlr References 
Removed from Kernel 

The VAX-compatible terms pObr and p0 lr have been replaced in the kernel 
with nonVAX-dependent code. This reduces confusion when porting the system. 

/move.s rbcopy() 

Transferred Byte by Byte 

Improperly aligned move . s : bcopy () transfers were very slow. Code was 
inserted to move data by longwords before the loop to move by bytes, causing a 
3 x improvement of longword over byte copying. 

ftruncate on /dev/zero 
Changed Major and Minor 

Device Numbers 

Calling ftruncate on a file descriptor corresponding to /dev/ zero 
changed the major and minor device numbers so the device eventually became 
unusable, itrunc () now verifies the type of inode before beginning an 
operation that might be senseless. 

mb 

mbugo called xxgo with an invalid md->md_mbinf o. After dvma ran out, 
mbrelse was eventually called to release dvma. This caused a call to mbugo 
to map dvma’s for devices that were waiting while dvma had run out, some¬ 
times resulting in mbugo calling xxgo with an invalid md->md_mbinfo. 
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mmpeekio Extra break statements in mmpeekio in mem. c prevented the transfer of more 

than one short or long per call to mmpeekio. This has been fixed. 


UDP The kernel variable udpcksum was set for UDP packets and turned on the 

checksum. The checksum did not, however, take effect on NFS, since NFS uses 
its own path through the network code when sending packets. This is fixed with 
a change to the NFS packet-sending module. 


skyrc The kernel panicked on a Sun-2 with a Sky floating-point processor board. 

This bug was fixed earlier, and the new skyrc file is included in this release. 


Lost Files and vm_hat On 128-megabyte Sun-4 systems, the pmem test did not produce one pass in 48 

hours. Also, in some circumstances, an NFS server could lose a write to a file if 
the file was written on a SunOS 4.0 server while being accessed for an NFS read 
request. The written data would be part of the file for a while, but the same file 
would have old or spurious data if the data had to be reread from the disk. This 
is fixed by changes to the vm_hat files. 


yppush A 3/260 yp master server crashed with the message panic: bus error, 

every time an attempt was made to push a yellow-pages map. 

An odd set of circumstances in the tcp/ip/ethernet layers of code tickled 
a bug in ether_pullup (). The bug is fixed. 


HZ Exists in The HZ parameter returns ticks per second according to syscalls that return 

<sy s/param. h> for Older values in ticks, getrusage () does not return values in ticks. It returns 

System Compatibility struct t imeval, parameters that are independent of the clock resolution. 


sizecheck Now Owned by The makefile attempted to change the file-access permissions of sizecheck 
Builder during standalone driver build. The make aborted unless you owned the file. 

All users now have execute permission when sizecheck. sh retrieves from 
sees. 


lint Did Not Work for The makefiles have been changed so you can run lint on standalone drivers. 

Standalone Drivers 
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15.5. SCSI Drivers Bugs 
Fixed 


Length Errors on SCSI Tape 


biowait Hang with 
SCSI Va" Tape 


SCSI-3 Driver Module 
si_cmd() Did Not Catch Bus 
Error 


No ID on Arbitration of SCSI 
and SCSI-3 Driver 


Missing #include Statement 


SCSI Tape End-of-File Flag 
Not Cleared 


The list of bug fixes in SCSI drivers includes 1/4" tape drivers and onboard SCSI 
and SCSI-3 drivers. 


Length errors are generated when the blocking factor during a read does not 
match the blocking factor used when recording. These are no longer fatal errors, 
and tape operation can continue. 

physio notices the requested transfer count does not match the actual count and 
issues another I/O request. This takes care of the problem. 


The following command would hang after writing some files to tape because 
biowait on the physio buffer was still marked BUSY. 

find . -print | cpio -ocB >/dev/rst8 

This was a general SCSI problem. The code has been changed, and this bug is 
now fixed. 


This module can return a value of ok, fail, scsi_FAiLor hard_fail. 
When called by sidone () and sigo () of si. c, the error checking did not 
detect the possible value of scsi_fail; in the interrupt service routine 
siinter, error checking did not check scsi_fail and hard_fail after 
si_cmd was called. 

In si_cmd, hard_fail is now returned and this fixes the bug. 


The driver would enter arbitration phase without asserting proper ID on the SCSI 
data bus, leaving the contents of the Output Data Register undetermined and with 
a leftover of the previous SCSI transaction. SCSI driver code was changed, and 
this bug is now fixed. 


The following line was missing from / sc_conf. c for Sun-4, preventing a 
build on some machines. 

include sw.h 

Two lines of code were added to fix this bug. 


If end-of-file occurred during a read, the EOF flag did not clear when the driver 
closed. 


15.5. SCSI Drivers Bugs 
Fixed 


Length Errors on SCSI Tape 


biowait Hang with 
SCSI Va" Tape 


SCSI-3 Driver Module 
si_cmd() Did Not Catch Bus 
Error 


No ID on Arbitration of SCSI 
and SCSI-3 Driver 


Missing #include Statement 


SCSI Tape End-of-File Flag 
Not Cleared 
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SCSI Tape Driver: f s f Errors 


Sysgen Tape Controllers: File 
Positioning 


Tape File Positioning 
Errors in st. c 


Misleading Messages when 
Cartridge Not in Drive 

Extra File Marks on SCSI Tape 
after writi. sp 


SCSI Error Recovery Generated 
Bus Error in scdone 


tapetop Test Would Hang 
with SCSI Tape and SMD Disk 


SCSI Driver Refused Send- 
Data’s Odd-Length Transfer 


The driver did not report the location of file-space errors. If such an error 
occurred at beginning-of-tape, an auto-format search was sometimes triggered. 

The driver did not report the position of the file when a file-space error occurred. 
If the error was a blank-check error and occurred at beginning-of-tape, an auto¬ 
density check was sometimes triggered. 

f sr and bsr file-positioning operations for ioctl functions now work with 
Sysgen tape controllers. 

End-of-file and end-of-tape error reporting is the same as that of tar and 
dump: errors are not posted, and only a residual count is returned. Such a report 
is not seen as an error by the ioctl file-positioning operations f s r, bsr, 
fsf, and bsr. The file was changed so that EOF/EOT error reports now flag a 
failure of the requested operation. 


When the 14" tape drive is accessed and there is no cartridge in the drive, the 
SCSI tape driver now prints a sensible and informative screen message. 


If, after a tape write, the SCSI tape driver is closed, then opened and closed again 
without writing any data, the driver writes an extra file mark. 

A path through SCSI (sc. c) error handling resulted in a bus error panic 
(kernel trap, invalid reference) from the scdone () routine. 
Changes to a critical code section in the sc driver have fixed this bug. 

The tapetop 14" test in sysdiag would hang at startup, showing neither 
pass nor cycle during 48 hours of run-in with an SMD disk. Rebooting produced 
the message Some processes wouldn't die. This was determined to 
be a SCSI driver problem, and is fixed. 


The sc. c SCSI drive did not handle the odd transfer length condition for the 
case of a send-data command. Research found a coding error specifying 
receive-data instead of send-data in the odd-length routine. The code is changed 
to fix this bug. 


SCSI Tape Driver: fsf Errors 


Sysgen Tape Controllers: File 
Positioning 


Tape File Positioning 
Errors in st. c 


Misleading Messages when 
Cartridge Not in Drive 

Extra File Marks on SCSI Tape 
after writi. sp 


SCSI Error Recovery Generated 
Bus Error in scdone 


tapetop Test Would Hang 
with SCSI Tape and SMD Disk 


SCSI Driver Refused Send- 
Data’s Odd-Length Transfer 
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swO_cmd: Reselect 
failure on SunOS 4.0 with 


SCSI Patch 


The reselect failure message was inaccurate, and was changed to indi¬ 
cate that a lost hardware reselect interrupt was recovered in software. Hardware 
involved was a SCSI 155-megabyte disk with a 150-megabyte tape on a Sun- 
4/110 running bootprom 2.8 on Sundiag 1.0beta2. 


Bus Failure Prevented Recovery 
of Disk I/O for Swap 


A bad Archive embedded SCSI tape controller allowed the SCSI bus to fail, and 
disk I/O for swap was not recovered. The bug was found after a screen message. 
Panic: segu_swapin: getpage failed, showed a failed command 
after missing command phase. 


SCSI Failed when 
Dumping Core 


Error messages about sdO :, swO :, st 0 indicated that sddump routine 
and sdt imer failed to reset the bus to clear out all other SCSI I/O before doing 
SCSI I/O; an IL1-A1 abort was required to recover. This is fixed. 


15.6. Serial Drivers Bugs Serial driver bugs in the following list are now fixed. 
Fixed 


Redirecting Console 
to Serial Device 



A serial driver redirecting the console to a serial device no longer fails with error 
number 25. 

A few lines of kernel code now equate console device with device ; this ensures 
that the TIOCCONS call is recognized by all serial devices, not just pseudotermi¬ 
nal pty. 


Software Carrier Detect Flag The software Carrier Detect flag was turned off by the MCP driver. This bug is 
Turned Off by MCP now fixed. 


DTR Asserted on Modem Line 
while Port Is Not Open 


Data Terminal Ready was asserted while the communications port was not open, 
allowing the modem to answer with no getty waiting on the line. This bug is 
now fixed. 


DTR Dropped Too Soon after The modem did not recognize a less-than-one-second drop of DTR in cases when 

Serial Port Close the port was reopened immediately. Increasing DTR drop time to at least one 

second fixed this bug. 


Modem Status Unreadable 


It was impossible to read the modem status flags from an ALM or ALM-2 port. 
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Flow-Control Problems with 
ALM Board 


4.0 Crashed on Reboot If ALM 
Board Was Missing 


ALM-2 Acted Up when 
Switching Between Raw and 
Cooked Mode 


Multiple ALM-2 Boards Did 
Not Work Reliably 


UUCP Unworkable at 
Transmissions Greater Than 
9600 Baud 


Timeout Table Overflow by 
MTI Driver 


pty Driver Could Hang on 
Writes to Master Side 


Intermittent Flow Control 
Problems on ALM with Plotter 


Sun-3 users experienced intermittent flow-control problems with printers operat¬ 
ing from an ALM board. (The problems occurred when printing graphics and 
when running the serial port in LLITOUT.) All known ALM flow-control 
problems have now been fixed. 


When SunOS 4.0 was configured for the ALM board and the board was not 
installed, a reboot caused the system to crash on a Sun-2, Sun-3, or Sun-4. 
This has been fixed so that a screen message advises that the board is missing. 


When using application programs such as vi with an ALM-2, the 
mcp_async driver was not waiting for data to be properly flushed before 
changing the mode information for the MCP. 


In a system with multiple ALM-2s, only board 0 worked reliably; units 1,2, 
and 3 locked up, failed to respond, or responded improperly. 

A one-line code change in the driver corrected attempts to reset all interrupts as 
though they were generated on board 0 and fixed this bug. 


The tty driver input to the read queue did not drain fast enough when input was 
thick and fast; when the read queue filled, all input was discarded. The driver 
was rewritten to increase queueing, buffering, and drain efficiency. The bug is 
now fixed. 


When characters came too fast, the 4.0 MTI driver queued multiple timeouts and 
overflowed the timeout table. 

The bug was fixed by rewriting the driver to note that one timeout is already 
queued and to avoid queueing additional ones. 


Large writes to the master side of a pseudoterminal (pty) can be read-queued to 
the upstream slave-side pty driver. If that queue is full, the master side blocks 
until it empties, but it sleeps on the wrong event and, if the queue empties again, 
wakeup never occurs. This is usually masked by a write to die slave side where 
echoed data causes wakeups. 

This bug is fixed. 


The port would eventually hang, and when XON was sent there was no response. 
The flow control machine was not stripping the parity bit. The new general tty 
patch tape corrects this bug. 


Flow-Control Problems with 
ALM Board 


4.0 Crashed on Reboot If ALM 
Board Was Missing 


ALM-2 Acted Up when 
Switching Between Raw and 
Cooked Mode 


Multiple ALM-2 Boards Did 
Not Work Reliably 


UUCP Unworkable at 
Transmissions Greater Than 
9600 Baud 


Timeout Table Overflow by 
MTI Driver 


pty Driver Could Hang on 
Writes to Master Side 


Intermittent Flow Control 
Problems on ALM with Plotter 
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ALM-2 Driver Was The ALM-2 driver appeared to be dereferencing a null pointer. A code change in 

Dereferencing a Null Pointer the driver fixed this bug. 


lpr Panicked System Using The lpr command caused the system to panic if the printer was using an 

ALM-2 Parallel Port ALM-2 parallel port. 

Rewriting code in the MCP drivers has fixed this bug. 


Serial I/O Did Not Work Printing stopped and output was truncated after printing two or three pages. 

Reliably Terminals ignored flow control. Toggling printer off, then on, performed a 

manual restart. 

There were intermittent flow-control problems, with an ALM board on a Sun-3 
running 4.0 and earlier, while printing graphics. Another user reported truncated 
terminal output when using a plotter in 4.0. 

A new flow control module has been written and integrated into all the serial 
drivers. The bug is now fixed. 


15.7. Network Bugs Fixed The network bugs were variously found in the network file system, protocols, and 

other areas. 


Security Hole in yppasswd A security hole in yppas swd has been fixed. 


PC-NFS Search Paths 


The search PATH of a PC-NFS client could, by mistake, include an NFS- 
mounted file that was not a directory. An attempt to read this “directory” 
could crash the server. 


Sun-4 Gateways Hung 


Sun-4 gateways sometimes hung, requiring a gateway reboot. 


Spurious VME Interrupts 


Spurious VME interrupts occurred at processor level 5. 


Internet Name Server Crashes Random crashes occurred in the Internet name server /usr/etc/in. named. 


Checksum Not Occurring 


The udpcksum variable did not cause NFS to perform a checksum. 
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Broadcast Address Not Reset The if conf ig command in /etc/rc. local did not reset the broadcast 

address; it set the netmask only. 


Limited Maximum TCP (Internet Transmission Control Protocol) limited MSS (Maximum Segment 

Segment Size Size) to half the window, degrading performance on netwoiks with large package 

sizes. 


Break-out Routine Called In the routine ether_output, the code called the break-out routine, setting the 

in Error type variable to the protocol family entry from the registration field. 


passwdand yppasswdDid There was confusion with rpc when passwd encrypted the secret parameter 
Not Reencrypt Correctly of chkey.cand yppasswd decrypted it. Code changes have cleared the 

confusion and ensured secure rpc. 


makedbm Returned makedbm: Yikes ! indicated that the source file was inappropriately format- 

inappropriate Message ted when doing a make-netgroup from /var/yp. The message has been 

changed to be more informative. 


ftp Bug When there was an anonymous ftp account, a command to change the working 

directory to 'root would overwrite the struct passwd returned by getpwnam at 
the initial login. Code has been changed to copy struct into another variable. 
This closes the hole that allowed root access to the system, and fixes the ftp 
bug. 


nf s Destroyed Files When a file was checked out using query. c, edited, and compiled, and then a 

sees dif f s made in preparation for checking it back in, the SCCS file was 
destroyed. 


Id error -98 with Creating a make_doc with gnuemacs release 18.51 brought an Id error 

make_doc from gnuemacs -98 message when the directory was mounted from a 4.3 BSD system onto a 

Sun-4/110 running SunOS 4.0. A code change has fixed this bug. 


NFS-Based open Did Not Occasionally the NFS data cache for a file was not flushed, even when data was 

Generate Network Status incorrect; and a network stat did not necessarily take place after an open. 

Instead, attributes sometimes came out of the local cache. This has been fixed by 
nf s_open forcing an over-the-wire getattr and by using the attributes to 
check caches. 
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Shared Locks Did Not Turn Off A process opening a shared lock on a remote file could not always read the most 

NFS Caching current contents of the file, suggesting that NFS caching was not turned off. 

Code changes have fixed this bug. 


NFS Data Caches Not Sometimes the NFS data cache was not flushed, even though the data was 

Always Flushed incorrect; this generally occurred in vi. One line of code was deleted, disallow¬ 

ing the invalidation of the cached attributes, and fixing this bug. 


NFSD Swapped Out Under heavy NFS usage, NFS daemons were swapped out and could not be 

killed except by a reboot. Some systems had many nf sd running. New code 
has been written to take care of this bug. 


rpc. lockd Exclusive locks always succeeded for local files, but a lock request from a 

remote client failed. 

rpc. lockd dumped core after several hours of execution. 

The lock manager under 4.0 sometimes failed with the message, Can't talk 
to local statd, causing processes using the lock manager to enter‘D’state 
and stay there. Code changes to rpc. lockd have fixed these bugs. 


rpc. mountd The mount daemon did not allow a host to mount a filesystem listed in an rw= if 

it was not also listed in access=. 


Bad IP Checksums on In transmission protocols the IP checksum was calculated by an algorithm that 

Some Packets made it possible to generate several packets in sequence with bad checksums; 

this could cause an NFS operation on a soft-mounted file system to fail. A brief 
code change has fixed this bug. 


Broadcast Requests Looped Ethernet drivers were looping back broadcast requests through the loopback 

Back to Originating Machine driver with a different netmask; this led to a machine incorrectly answering its 

own I CMP_NE TMAS K broadcast. A change of code has fixed this bug in this 
release. 


ypserv with Interdomain If ypserv was using the interdomain resolver, the yellow pages library did a 

Resolver Hangs mount bogus match on an empty string, and ypserv attempted to resolve the empty 

string. 

Yellow pages library code is changed to ensure that ypmatch and ypserv do 
not attempt to operate on an empty string. 
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ypbind 


yppasswd 


rsh and rlogin Failed Due 
to Order of hosts, equiv 
Entries 


panic: dirremove During 
PC-NFS Writes to NFS- 
Mounted Filesystems 


15.8. Compiler Bugs Fixed 


No Recursive Check for Shared 
Libraries 

Id Error Message 


Id: Library Name and Common 
Name Collided 


Id Option Could Not Be 
Turned Off 


Under server loads greater than 8, yellow-pages operations sometimes failed 
when ypbind was unable to write the binding file in time and, in effect, 
became one of the top users of CPU cycles. 

The code has been reordered to update the file in a more rational way. 


It was discovered that the rpc. yppas swd program could be breached in 
SunOS 3.x or SunOS 4.0 if a program was written where yppasswd was used 
in place of rpc. yppasswd; this allowed a line entry to be added to the pass¬ 
word file. 

The code has been changed to fix this bug. 


Remote operations failed when the order of the entries in 
/etc/hosts . equiv did not match the order of entries in /etc/hosts, 
and long host names with dots were not correctly recognized. Code changes 
have fixed this bug. 


Writing to an NFS-mounted filesystem through PC-NFS sometimes caused a 
check in uf s/uf s_dir. c to generate a panic: dirremove condition. 
This apparently occurred when an application on the PC attempted to remove 
files in the remote filesystem. (This should only occur when attempting to 
remove a directory with a null, or zero-length, name.) 

Bug fixes associated with the compiler library and linker are listed in the next 
sections. 


The link editor Id did not recursively check for shared library dependencies. 

While linking an executable comprised of two objects (one constructed as a “-r” 
of several objects) and the System V shared C library, the link editor Id returned 
an error message. 


When using Id, if a collision occurred between a library name and a common 
name, all references were relocated to the library name. This bug has been fixed. 


The Id option, -assert definition, could not be turned off. 

A -noas sert option has been added to Id and the compiler driver updated. 


ypbind 


yppasswd 


rsh and rlogin Failed Due 
to Order of hosts, equiv 
Entries 


panic: dirremove During 
PC-NFS Writes to NFS- 
Mounted Filesystems 


15.8. Compiler Bugs Fixed 


No Recursive Check for Shared 
Libraries 

Id Error Message 


Id: Library Name and Common 
Name Collided 


Id Option Could Not Be 
Turned Off 
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Nonspecific Exit Codes in 
Id. so Caused Clumsy 
Recoveries 


Id. so Operated Incorrectly in 
Dynamic Binding to a Common 


Nonstandard Link Command 
Generated adb and rm 
Failures 


Id with -A, -x Options 
Produced Bad Output File 


Watch Points Not Working 
Correctly 

Bit Fields Displayed Incorrectly 

Compile with -Bstatic 
Option Failed on 4.0 EXPORT 


newkey Failed 
under 4.0 EXPORT 


The single exit status returned by Id. so, 127(10), made for gross recoveries 
from temporary failures—mail aborted instead of being requeued. The linker 
code is changed to return more specific exit codes, conforming to the standards in 
sysexits . h, and this bug is fixed. 


If a dynamic binding to a symbol that was actually a common occurred, Id. so 
would crash or perform the binding incorrectly. Code has been changed that 
resets the object identity in the Id. so lookup cache and records the link map 
entry for main. This bug is fixed. 


The link command, Id -N -T 0 -o filenamesJilenames, caused both adb 
and rm to fail. The command would create a bad symbol table in some cases. 
This bug is fixed. 


Work around this by omitting the -x option; this produces an executable with a 
readable symbol table. The executable contains the symbol _DYNAMIC, which 
may also be an error. 

The following data watch points did not work properly: stop <var>, stop 
IF, and when. 

dbx did not display the bit fields of a C structure correctly. 

Id produced an obscure error message when linking an executable comprised of 
two objects and the SystemV shared C library. It was found that no options were 
passed to Id in Makefile. inter. The lack of certain options implied that 
a shared object was being built. These bogus shared objects were included in 
libc. a, producing the error message 

_etext: /lib/libc.a(des_crypt.o): multiply defined 
This bug is fixed. 


The command, newkey -u root, followed by a password, resulted in the 
message Id.so: call to undefined procedure _cbc_crypt 
from 0x20196 when the file cbc_crypt in libc . so was missing. 
Changes were made to Makefiles in /usr / sr c/bin, 

/usr/scr/usr.bin, /usr/src/usr.etc/yp, and 
/usr/scr/Makefile. inter, and recompiled to fix this bug. 


Nonspecific Exit Codes in 
Id. so Caused Clumsy 
Recoveries 


Id. so Operated Incorrectly in 
Dynamic Binding to a Common 


Nonstandard Link Command 
Generated adb and rm 
Failures 


Id with -A, -x Options 
Produced Bad Output File 


Watch Points Not Working 
Correctly 

Bit Fields Displayed Incorrectly 

Compile with -Bstatic 
Option Failed on 4.0 EXPORT 


newkey Failed 
under 4.0 EXPORT 
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Older Sun-2 Object Files 
Failed to Link 


Dynamically Linked Programs 
Require Page-Aligned Stack 
Limit to Execute 


a. out Died without Error 
Message 


Id Error Message when 
Linking Two-Object Executable 
and Sys V Shared Library 


opreg 


target 


Sun-4 /bin/as Dumped Core 
with /.stabs -01 -S 


Attempting to link archived object files with machine type 0 (m_oldsun2) pro¬ 
duced the message, Id: <file>: wrong machine type. This was fixed 
by expanding the check for M_68010 to allow an m_oldsun2 object file. 


Id. so obtains the stack-size limit when building a heap for itself at the stack 
extreme limit. If the stack-size limit (in bytes) is not page-aligned when passed 
to the mmap () system call, mmap () fails the mapping request with an error 
message similar to this: Id. so: map heap error (22) for 
/ dev/zero. 

Id. so now rounds up the value of the stack-size resource limit to the next 
whole page before using it. 


If the _dynamic data structure of a program using shared libraries was cor¬ 
rupted, the program died without any error messages from the run-time loader. 
Id. so now checks the version number in _dynamic of the a. out that 
calls it 


This happened when Id option -e (entry point) was placed on the command line 
after the name of the file to be processed. Id allocated more space than needed 
for the string area. This bug is fixed. 


When a C function call returns a structure and includes arguments of type float, 
the arguments are converted to double; however, SunOS 4.0 and Sys4-3.2 com¬ 
pilers did not convert them. This is fixed by changes to the / u s r /1 ib / c com 
file, but requires renaming (and saving) the old lib/ccom to keep it out of 
mischief. 


target in a. out. h and set jmp. h conflicted with compiler builds; 
Pascal 1.1 could not build on a 4.0 machine. The files have been changed to fix 
this bug. 


The Sun-4 assembly/optimizer could dump core if . stabs and . stabn were 
present, optimization was enabled (-01), and disassembly was enabled (-S). This 
bug is fixed. 


Older Sun-2 Object Files 
Failed to Link 


Dynamically Linked Programs 
Require Page-Aligned Stack 
Limit to Execute 


a. out Died without Error 
Message 


Id Error Message when 
Linking Two-Object Executable 
and Sys V Shared Library 


opreg 


target 


Sun-4 /bin/as Dumped Core 
with /.stabs -01 -S 
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15.9. Debugger Bugs Fixed Both dbx and dbxtool required changes to fix these problems: 


dbxtool 


dbxtool was putting corrupted filenames in the top window. 


dbx 


dbx was not dealing with object files with multiple N_SO entries, not knowing 
that . for and . vf suffixes imply fortran, nor correctly handling source files 
with the same prefix, such as a. for and .f. 

On Sun-4, a Fortran do loop caused dbx to print spurious values; dbx was 
not correctly displaying variables assigned to SPARC 1 registers. 

next and step could not step over floating-point branches on a Sun-4 running 4.0; 
step over fp failed. 


dbx did not always apply USE-path when searching for source; as an example of 
the failing, in this program both diagnostics and the failure to set a breakpoint are 
errors: 


mkdir a 
mkdir b 
cd a 

cat > a/c « EOF 
main (|) 

{ 

} 

EOF 


» 

» 


cc -g a.c 
mv a.c ../b 
dbx a.out 
use ../b 
file a.c 

warning: File 'a.c' 
stop at 3 

file "../b/a.c" was 
status 


has not been 
not compiled 


comp[iled with the -g option 
with the -g option 


dbx was unable to read a core file on a Sun-4 with shared libraries; running 
dbx on an executable that dumped core gave this message: warning: 
object file read error: text address not found 

dbx could not deal with object files with multiple n_so entries; it did not know 
that .for and . vf implied Fortran, and never correctly handled multiple 
source files with different prefixes. Compiler code change has fixed this bug. 

The dbx step command took longer to execute on a Sun-4 than on a Sun-3. 

This is no longer the case. 
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15.10. Utilities Bugs Fixed 

System utilities bug fixes are described here. 

xt 

Interrupting the xt tape read/write would hang the driver. 

syslogd 

syslogd failed to define loghost name, causing a syslog race condition. 

catman 

The utility /usr/et c/catman -p failed with an error message. 

l P r 

The usage lpr -r -s could conceivably delete files on a remote host and 
produced an error message such as the following in the printer log file: 

/usr/lib/lpd: imagen: 776 6: open failure <errno = 2> 

graph(1G) 

When attempting a multiple operation pipe — splinelgraphlplot— on Sun-4, 
graph went into an infinite loop; graph also gave incorrect answers on Sun-4. 
This is fixed. 

Security Holes 

There were security holes in sendmail and in the in. f ingerd daemon. 

tar 

Executing tar with the xcf options (instead of xvf) as in the following 
example erased the floppy. 

tar xcf /dev/rfdOa 

login(1) 

A password entry with a negative user ID and no password defaulted to root; 
login has been changed to fix this. 

passwd Created Password 

Entry if /etc/passwd 
Contained Blank Lines 

Library routines getpwent, getpwnam, getpwuid just skipped over and 
did not do anything about blank lines in /etc/passwd. The code has been 
changed so blank lines are no longer mapped to an empty password, and existing 
empty password entries are stripped from the file. 

uuxqt 

Attempts to execute a command with uuxqt on Sys4-3.2 failed with an XQT 
DENIED message. A ‘bad command’ debugging error message was issued after 
checking the ‘L-cmds’ and USERFILE files. This has been fixed. 

lpd Dumped Core when 
Filename Exceeded 132 
Characters 

lpd used a fixed-size buffer for banner lines; when the line was too long, it 
dumped core. This is changed to dynamically allocate space for banner lines. 


Xr microsystems 
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lpd Passed -w0 Default when 
lpr Width Unspecified 


Chesstool Froze 

Segmentation Violation 
Occurred In chesstool 


/usr/kvm/m68k on Sun-3 
Running 4.0 Is Incorrect 


Printer Log File Error Messages 
Not Shown 


lpr -s Rejected Files on 
Remote Filesystems 


lpd Mailed Remote-Print Error 
Report to Illegal Address 


15.11. System 

Administration Bugs 
Fixed 

format 


The width parameter was set to 0 unless the user specified a different value using 
the -w option of lpr. The default has been changed. 


The Chesstool would freeze when it was time for the computer to make a move. 

Commands to Start game. Move any piece. Choose "Machine 
White" or "Human White", Choose either "Cancel" or 
"Restart " in any combination caused a segmentation violation. It was found 
that the panel-notify procedures in chesstool. c were declared with the 
wrong argument list, and an argument was dereferenced in machine^proc. 

The code has been corrected. 


During a build on a Sun-3 (but not on Sun-4), the file / u s r / k vm/m6 8 k 
incorrectly pointed to false and propagated the evaluation of m68k as false. The 
link was changed from /bin/false to /bin/true to correct the problem 
in 4.0.1 and higher. 


st derr for the line printer daemon filters other than the output filter was 
directed to the error file instead of the logfile. This is fixed so all messages from 
filters are placed in the log file and mailed to the user. 


stat () returned a device number that was entered as negative in the control 
file, lpr did not recognize negative numbers and rejected the file. Code was 
changed to enter the device number in unsigned form, and the bug is fixed. 


The local printer daemon did not read user and host names, so when an error 
occurred, it sent the error report to ‘ Code was changed to have lpd read the 
user and host names from the control file. 


There were a number of bugs pertaining to format which have been fixed. A 
few others of miscellaneous character are also corrected. 


When format dumped the defect list to a file, the list began with defect number 
0. When printed, however, the list began with defect 1. This has been fixed so 
that defect numbering always starts at 1. 

Disks formatted on Xylogics 450 and 7053 controllers were not compatible. 

format aborted if it tried to spare a mapped sector. The program now ignores 
bad sectors if they are already mapped. 


lpd Passed -w0 Default when 
lpr Width Unspecified 


Chesstool Froze 

Segmentation Violation 
Occurred In chesstool 


/usr/kvm/m68k on Sun-3 
Running 4.0 Is Incorrect 


Printer Log File Error Messages 
Not Shown 


lpr -s Rejected Files on 
Remote Filesystems 


lpd Mailed Remote-Print Error 
Report to Illegal Address 


15.11. System 

Administration Bugs 
Fixed 

format 
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format Corrupted Kernel Map 
and Dumped Core with 
Incorrect Disk Type Selection 


format Aborts if Defect Spans 
into Next Also-Mapped-Bad 
Sector 


Defect List Difficult to Recreate 


Long Hostnames Caused 
Boot to Fail 


In a spare sector, the extract command missed a defect if it was the only one on 
the track. 

format did not provide a failure message when the label command of the util¬ 
ity failed. The code of label has been modified to warn the user of a labeling 
failure. 

An SMD disk drive formatted under 4.0 was ruined if subsequently formatted 
under 3.5 or Sys4-3.2. This bug has been fixed with the rewriting of format. 

Defective tracks on the disk drive were not brought to the attention of the for¬ 
matter. The track-defective bit was not checked when original defect informa¬ 
tion was read from the disk. In the rewritten format, the bit is checked and, if 
set, an error is returned. This ensures that defective tracks are not used. 

format, when run with a 451 controller, did not understand a long last sector 
following the data and, when a defect was found in such a sector, the format 
failed. The rewritten format now understands drives with long as well as 
short last sectors. 

format displayed misleading and unnecessary warning messages when 
irrelevant data was destroyed in the formatting process. Rewriting format 
has fixed this bug. 


When format did not find an incorrectly selected disk type in format.dat, 
it dereferenced a null pointer when setting up the default partition table, 
format is rewritten and this bug is now fixed. 


format could not properly handle a bad sector when the defect entry spanned 
the next sector which was also bad. Program code is changed so the defect entry 
does not span into the next sector. 


If forced to re-enter a defect list from hardcopy, you could not recreate the list 
with an editor (such as vi) or an optical scanner and then load the list with the 
defect/load command. (The operation failed with bad magic number or 
corrupt defect file.) Instead, you were forced to use a more time- 
consuming method (the defect/add command). 

The format program now allows either method. You can load any defect list as 
long as the first line is of the form: 

0x1 <number of defects> 0x123 


If you had a server with a hostname longer than 16 characters, booting diskless 
clients failed. 


format Corrupted Kernel Map 
and Dumped Core with 
Incorrect Disk Type Selection 


format Aborts if Defect Spans 
into Next Also-Mapped-Bad 
Sector 


Defect List Difficult to Recreate 


Long Hostnames Caused 
Boot to Fail 
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Sundiag Test Could Fail 

The Sundiag ipct ext could fail, telling that the time limit for the test had been 
exceeded, because the test-start message was not received. 

Security Holes 

There were security holes in passwd, getpwent, getpwnam, and 
getpwuid. 

Remote shutdown Failed 

When the console received a root rlogin from a remote machine followed by a 
shutdown -h now command, the system would hang after displaying Sys¬ 
tem going down . . . or the Login: prompt, and did not do a disk sync. 
The halt was aborted when ttyname () returned a null; and null was returned 
because shutdown kills rlogin before it executes halt. This bug is fixed 
by having halt use "(no tty)" in the audit record when ttyname () returns 
NULL. 

Shutdown Truncates the 
/etc/nologin Warning 
Message 

The first letter of the shutdown message in /etc/nologin was cut off. This 
has been fixed. 

mount Returned Incorrect Line 
Number for Illegal Entry in 
f stab 

mount obtained the line count from valid entries returned from the 
getmntent () routine which ignores commented-out lines. An added routine 
now allows mount to return the correct line number in the error message, even 
though one or more lines are commented out. 

rpc .mountd Rejected 

Request for Exporting 

Filesystem to everybody 

When rpc. mountd could not map a caller’s address to a machine name, it 
rejected the request, rpc. mount d is rewritten with a bogus host entry struc¬ 
ture when the client address cannot be found with regular methods to fix this bug. 

SCSI Defect List not 

Dynamically Allocated by 
format 

format formerly allocated a static amount of memory for SCSI defect lists. 

If defects exceeded 127, a bus error was issued. Rewriting format has fixed 
this bug. 

Bus Error Resulted When 

Logical Defect Was Added to 

Null Defect List 

When creating a null defect list and doing an add command in the defect menu 
by selecting the logical defect option, the first defect caused a segmentation 
violation. This is fixed with the rewriting of format. 

System Accounting Bug Fixed 

The system accounting utility, /usr/etc/sa, could not accommodate a user 
ID greater than or equal to 65526. When such an ID was encountered, sa 
would loop indefinitely and, at the same time, another sa would be restarted 
daily by cron. This quickly degraded system performance. This bug is fixed. 


#sun 

\T microsystems 
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s c s i. h File not included in The SCSI/ALM patch tape did not include s c s i. h and was not compatible 

4.0 SCSI/ALM Patch Tape with Sun consulting specials. This was not a bug, and the oversight is corrected. 


15.12. SunView Bugs Fixed There were two fixed bugs for SunView. 


sunview Exited Leaving When sunview exited, the screen was left in reverse video and text and 

Video Reversed prompts in normal video. A change in suntools. c now saves planegroup 

colormaps when starting, restores them when exiting, and checks the 0th red 
entry for CG8; this fixes the screen reverse video bug. 


Shared Libraries Had Incorrect Shared libraries, libsuntool and libsunwindow, acquired different 

Version Number Warnings minor version numbers for Sun-2 and Sun-3; this brought incorrect version 

number warnings when a binary built on a Sun-2 was run on a Sun-3. Code 
changes in the shared library files fixed this bug. 


perfmeter 


The perfmeter occasionally dumped core on startup. This was caused by a 
divide-by-zero bug, and is now fixed. 


15.13. Sunlnstall Bugs 
Fixed 

Non-zero exit suninst all no longer terminates because of non-zero exit status in extracting 

files from tapes. 


setup_client 


Dataless clients 


Diskless client 


setup_client now deals with substrings correctly in grep and it might cor¬ 
rupt /etc/exports and /etc/bootparams. 


Dataless client install now deals with substrings correctly. It now places the 
server internet address into /etc/hosts. Therefore, the dataless client can 
mount /usr, /usr/kvm, and /usr/share file systems when the system 
boots up. 

There is no longer a problem with create_root script if YP is not running. 

If the YP master went down and you were trying to create a client, when it 
reached the create_root script, the diskless client would not boot up. YP 
had a problem and could not ypmatch SSERVER from the hosts YP data base and 
put it into the client’s /etc/hosts file. Then the diskless client had problems 
mounting the file system. This is no longer the case. 
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create_root 
Default ip Address Illegal 


Root Partition Could be 
Designated Free Space Hog 

Free Space Hog Not Used Soon 
Enough 


syslog. conf Caused Loop 


The setup_client Script 


/export / swap Partition Not 
Used Properly 


Setting Terminal Type to ‘other’ 
Dumps Core 


Screen Forms Changed 


The create_root now creates xdO and sd6 devices for a diskless client. 

The default ip address given by suninstall, 192.9.200.0, is a broadcast 
address and not a legal host address. 

suninstall allowed you to designate the root partition as the free space hog. 

If you selected too much software for the size of your /usr partition, sunin¬ 
stall would wait until the partition was totally full (110%) before starting to 
steal from the free space hog. 

The syslog. conf file that suninstall creates for a standalone machine 
caused syslogd to loop by indefinitely logging an error. This file has been 
changed to fix this problem. 

The setup_client script did not always determine whether yp was running. 
The script now performs a more reliable test. 

When installing clients on a server with a /export file system (including a 
/ export/swap partition), suninstall failed if the combined size of the 
client swapspaces exceeded the size of / export. 

On the suninstall form to select terminal type, selecting 4 (other) caused a 
core dump. This happened because the buffer used to parse the t ermcap file 
was too small. The buffer has been increased to the correct size. 

A number of changes were made to suninstall screen forms: 

□ Partition [ a ] no longer appears as an option for the Freehog Disk Partition 
in the Disk Form. 

□ The name of the Tape Information field in the Software Form has 
been changed to Media Information. 

□ Pressing [ CTRLA1 in the Software Selection form could dump core. This 
happened if the tape was rewinding or if the table of contents was being read 
from the tape. 


create_root 
Default ip Address Illegal 


Root Partition Could be 
Designated Free Space Hog 

Free Space Hog Not Used Soon 
Enough 


syslog. conf Caused Loop 


The setup_client Script 


/export / swap Partition Not 
Used Properly 


Setting Terminal Type to ‘other’ 
Dumps Core 


Screen Forms Changed 
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Documentation Errata 


This section supplements and, in some cases, supersedes the “Documentation 
Errata and Change Pages for SunOS Release 4.0.3.” It contains the following 
subsections, which correspond to document titles. 

□ Documentation Errata and Change Pages for SunOS 4.0.3 

□ Installing the SunOS 4.0.3 



Documentation 
Errata and Change 
Pages for SunOS 
4.0.3 


This section supplements the Documentation Errata and Change Pages for 
SunOS 4.0.3 with the latest information about the CG8 color board. 


24-Bit Color 


□ The “Overview” section (pp 1) should read as follows: 

The CG8 color has three plane groups: a 24-bit plane to represent true color 
images, and two monochrome overlay planes. For historical reasons, one of 
these overlay planes is called an enable overlay plane. Both overlay planes 
are 2-bit-deep colormaps that control the window-system plane combina¬ 
tions. The enable overlay plane, in combination with the overlay plane, pro¬ 
vides a third overlay color. 


o 



The “Plane Groups” and “Lookup Tables” sections (pp 4 through 7) are 
replaced. The new sections begin on the next page. 


microsystems 


121 
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A.2. Plane Groups Plane groups allow for the logical grouping of pixel bit planes. Pixrect has 

added a new plane group called pixpg_2 4BIT_C0L0R for accessing the 24- 
bit frame buffer. This plane group provides 24-bit RGB (red green blue) values 
stored in XBGR format in 32-bit pixels. All of the normal logical operations and 
plane masking are available. Many of the logical operations, however, are not 
useful with color. 

As shown in Table 1, the CG8 also has one overlay enable plane, a total of three 
plane groups for CG8 Pixrects. 

NOTE For the CG4, the enable plane served as a toggle switch that mediated between 
planes. For the CG8 and CG9 , this plane is a 2-bit deep colormap that in combi¬ 
nation with the overlay plane provides a third overlay color (a new capability 
provided by Sun Microsystems). 

Table 1 CG8 Plane Groups 


Plane 

Function 

PIXP G_OVERLAY 

PIXPG_OVERLAY_ENABLE 
PIXPG_24BIT_COLOR 

Window System Plane 
Window System Plane 
24-bit Color Plane 


The overlay planes are monochrome. They do, however, have their own two-bit 
deep colormap that controls the overlay and enable plane combinations. 

For each pixel, if both the overlay and overlay-enable planes are zero, the 24-bit 
frame buffer is visible. If any of the planes are non-zero, the pixel displays the 
color indicated in Table X-2. 


Table 2 Enable/Overlay Planes for the CG8 


Overlay Plane 

Enable Plane 

Color Index 

0 

0 

transparent 

0 

1 

1 

1 

0 

2 

1 

1 

3 


The colors can be changed and retrieved from the hardware through the 
pr_j?ut lut and pr_get lut calls. For example, after the call: 

( -V 

pr_putcolormap(pr, 0, 2, r, g, b) 

\ _ / 


the colors of the overlay planes are as follows: 


microsystems 
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Colormap Index 

Color 

0 

transparent 

1 

r[0] g[0] b[0] 

2 

unchanged 

3 

r[l] g[l] b[l] 


After this call: 


pr_j?utlut (pr, 0, 4, r, g, b) 


the colors of the overlay planes are as follows: 


Colormap Index 

Color 

0 

transparent 

1 

r[l] g[l] b[l] 

2 

r[2] g[2] c[2] 

3 

r[3] g[3] b[3] 


The foreground and background colors of the overlay plane can be set using the 
pr_j?utcolormap () command with the overlay plane as the Pixrect argu¬ 
ment. The colormap contains three 24-bit color values. 

NOTE: The default plane for the CG8 is the overlay plane, not the 24-bit plane. 

The following example code shows how to test whether the color board that the 
application uses supports 24-bit color. This type of code is important for writing 
portable software, that is, software that can run with either 8- or 24-bit color. 


♦include <pixrect/pixrect_hs.h> 
char maxgroup[PIXPG_24BIT_COLOR + 1]; 

pr_available_j?lane_groups(pr, PIXPG_24BIT_COLOR + 1, maxgroup); \ 
if (maxgroup[PIXPG_24BIT_COLOR] != 0) 

printf("Board supports 24-bit color\n"); 

_ 


A.3. True Color Lookup The CG8 includes a 24-bit color model. The board includes specific hardware to 
Table store and modify the default 24-bit Color Lookup Table, or True Color Lookup 

Table. 

After UNIX boot-up, the True Color LT is loaded with a default color table that 
is linearly ramped from minimum to maximum intensity in red, green, and blue. 
Certain computer graphics applications, such as offset printing and image pro¬ 
cessing, may require changes to the True Color LT. The /fBPixrect/fR software 
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library includes a software routine that supports changes to the 24-bit True Color 
LT. Use Pixrects library calls to make these changes. 

The CG8 has one Lookup Table for adjusting the intensity response of each com¬ 
ponent (red, green, and blue) of the 24-bit color values. You can use it to make 
the color response non-linear (Gamma corrected is one example), or to create 
special color effects. 

For each color component, the pixel’s intensity value serves as an index to the 
corresponding table entry. The value of that entry is then used as the actual 
intensity component for the displayed pixel. This interpretation can compensate 
for color inaccuracies generated by the display hardware. Therefore, by applying 
color correction techniques, such as gamma correction with the Lookup Table, 
the displayed image approaches True Color. 

The default table has no built-in gamma corrections. All applications share the 
same 24-bit Lookup Table, which you cannot divide into portions as you can 
with 8-bit colormaps. 

There are two new Pixrects routines that read and modify the 24-bit Lookup 
Tables: pr_getlut () and pr_j?utlut (). 






\ 

♦include <pixrect/pixrect_hs.h> 





♦define pr_putlut(pr, ind, cnt, red, grn, blu) 

\ 




(*(pr)->pr_ops->pro_putcolormap)(pr, PR_ 

_FORCE_UPDATE | 

ind, cnt, red. 

grn, blu) 


♦define pr_getlut(pr, ind, cnt, red, grn, blu) 

\ 




(*(pr)->pr_ops->pro_getcolormap)(pr, PR_ 

v 

_F ORCE__UP DATE | 

| ind, cnt, red. 

grn, blu) 

-j 


Using the pr_putlut () macro to load the Lookup Tables is similar to using 
the pr_putcolormap () function. The red [ ], green [ ], and blue [ ] 
array arguments correspond to the appropriate Lookup Tables. Similarly, 
pr_setlut () loads these same arrays from the Lookup Tables. 

The PR_FORCE_UPDATE value in the pr_putlut () macro is necessary 
because there is no colormap sharing in Pixrects. The sample program below 
illustrates the use of these macros. 


/ - \ 

♦include <pixrect/pixrect_hs.h> 

pr = pr_open("/dev/cgnineO"); 

pr_set_plane_group (pr, PIXPG__2 4BIT__COLOR); change to 24-hit plane 
pr_getlut(pr, 0, 256, red, green, blue); 
gamma_correct (red, green, blue) ; a user-supplied function... 
pr_j?utlut (pr, 0, 256, red, green, blue); 
v__—/ 


This part of the code opens the frame buffer, and changes the current plane group 
to 24-bit color (the default is the overlay plane). The pr_putlut () and 
pr_get lut () macros read and then reload the Lookup Tables. 



Revision A of 7 July 1989, Part. No. 800-3815-11 








Appendix A — Documentation Errata 125 


A.4. Omissions in CG8 The Documentation Errata and Change Pages for SunOS Release 4.0.3 manual 

Example Code contains example code for the CG8. There are two examples, one showing the 

use of the CG8 with the /fBPixrect/fR library; the other with SunView. These 
examples has some lines of code missing , which will prevent them from work¬ 
ing correctly. The missing code is shown below. 

The /fBPixrect/fR code has two lines of code missing: 

r -\ 

pr_set__plane_group (pr_cg8, PIXPG_OVERLAY) ; 

pr_rop (pr_cg8, off.x, off.y, rh->ras_width, rh->ras_height, 
PIX_SRC, 0, 0, 0); 

V_/ 


This code should be inserted in the pixrect code, directly after the lines 
-- 

pr_set_plane_group (pr_cg8, PIXPG__OVERLAY_ENABLE) ; 
pr__rop (pr_cg8, off.x, off.y, rh->ras_width, rh->ras_height, 
PIX_SRC, 0, 0, 0); 

V_> 


and before the comment 



This line should be inserted directly after the lines 
-- 

♦include <stdio.h> 

♦include <suntool/sunview.h> 

♦include <suntool/canvas.h> 

V._^ 


and before the lines: 


r 


■N 

Frame 

frame; 

/* Base frame. */ 

Canvas 

canvas; 


Pixwin 

*pwin; 


v_ 


_ 4 


With these lines inserted, the example code should work correctly. 
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Chapter 5, “How suninstall This chapter does not mention that you must select the SunCore software- 
Works” installation option in order to install the plot(lG) programs and plot(3X) 

library software. 


Chapter 6, “Walkthrough Tables 6-1 and 6-2 (page 125 and 127) incorrectly list the stO blocksize as 
Examples” 126b. The correct value is 200b. 

In Section 6.6, the DISK FORM (page 118) and the SOFTWARE FORM shown 
on page 120 are inaccurate. 

The DISK FORM should appear as follows: 


DISK FORM [bEL=erase one char of input: data] [RET=end of input data] 

Attached. Disk 'Devices 


Disk Label : : x[edit default] [edit existing] 

Free Hog Disk Partition : [d] [e] [f] [g] x[h] 

Display Unit : x[Mbytes] [Kbytes] [blocks] [cylinders] 


PARTITION 

START_CYL 

BLOCKS 

SIZE 

MOUNT PT PRESERVE(Y/N) 

:. — 



-52 


a 

0 

40200 ; ; ; 

20 

/ n 

b .. 

30 

67000 

'•***/. 3 4 ; 


C/jO-"' 

0 

1125600 

576 


d 

0 

" o: 

0 : 


e 

0 V 

0 

0 


f ■ : 

0 

0 

■ 0 .■ vx \ 



0 

'o-y/^: 

0 


h 


929960 

522 . 

/home n 


Ok to use this partition table [y/n] ? y 

Are you finished with this form [y/n] ? y 

[x/x=select choice] [space=next choice] [~B/"P=backward] ["F/“N=forward] 
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The SOFTWARE FORM should appear as follows: 


— 

SOFTWARE FORM [DEL=erase one char of input data] [RET=end of- input’ 


Architecture Information : 

Type :[sun2] [sun3] [sun3x] *{sun4] [sun4c] 


Path where executables reside: /usr 

Path where sub-arch dependent executables reside: /uar/kvm 
Media Information: ' 

Device Type : [stO] ||tl] [st2] [arO] [rntO] x[xtO] 

Drive Type v: x[local] [remote] 


Choice : [all] [default] [own choice] [required] [quit] 


Extract list: 

root 
Kvm : 
install 


Are you finished with this form [y/n] ? y 

[x/X=select choice] [space=next choice] [*B/*P=backward] [ ~F/ ~N=forward] 
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Chapter 9, “Performing a 
System Upgrade” 


□ Examples showing how to invoke sunupgrade needlessly begin with a 
cd command to change directories to /usr/etc/upgrade. The 
sunupgrade program is in your path . You do not need to change direc¬ 
tories or to specify a full pathname in order to invoke it. 

□ The displays at the top of pages 181,190,197, and 204 are incorrect. They 
should appear as follows: 

r —~~“—..... ...—”—"— —~——-\ 

NEXT STEPS 

* Install a smaller pre-configrured kernel using 
instaii_small_kernel (optional:) • 

* Reboot and come up single-user 
•* Check and install special_files 

(look in /usr/etc/upgrade/save) 

* Reconfigure your kernel (if you didn't install 
a small kernel) 

V___, 

□ The menu at the top of page 188 is inaccurate. The following screen lists the 
real menu choices: 

r .. ., .. -- - -..... .. ........................ •- " • . . -"-N 

Continue (y/n/q) ^ y 

Change clients usr file partitions from /export/exec (y/n): n 
Change clients root file partitions from /export/root (y/n): n 
Change clients swap file partitions from /export/swap (y/n): n 
Where is the tape drive located? (local | remote) : local 
Enter controller type ( st [ mt ] xt ): xt 

1. Upgrade all 

2. Upgrade Server only 

3* Upgrade clients of same architecture only 

4. Upgrade clients of other architecture only 

Select one of the above. The default is IV Enter choice: 1 
_-_____________;_> 
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□ The display at the top of page 189 is inaccurate. It should look like this. 
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The following pages supersede pages 1 through 6 in the PROM User’s manual. 
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PROM User’s Manual Addenda and 

Errata 


NOTE This addenda replaces the pages 2 through 8 of the PROM User’s Manual 
Addenda and Errata, published with the SunOS 4.0.3 release. 

The PROM User’s Manual describes PROM monitor commands, self-tests and 
extended tests for Sun-2 through Sun-386i systems. This text adds to or modifies 
the information found there and in the Addenda and Errata dated 24 April, 1989. 
This addenda applies to Sun-3 systems with the new, 2.8 version of the Boot 
PROM, and all Sun-3/400 series, the Sun-3/80 and SPARCsystem 330s. 

1. New PROM Monitor In the past, all numerical PROM monitor commands were entered in hexade- 

Command Feature cimal. If you have PROM version 2.8, or a Sun-3/400 series system, a Sun-3/80 

or SPARCsystem 330, you may now enter decimal or ASCII values after the 
PROM monitor prompt ( > ). This feature is particularly useful when using the 
monitor q command to program the EEPROM, which sometimes requires that 
you convert letters and decimal numbers to hexadecimal values before you enter 
them. 


To enter a decimal value after a PROM monitor command, simply precede the 
value with the character: 



If the value you enter is not preceded by a % or @ character, the monitor pro¬ 
gram treats that the value as hexadecimal. 

New "i Feature Entering the caret ( ~) and then an x when in PROM monitor mode (explained in 

the PROM User’s Manual) now displays a Boot PROM copyright message in 
addition to the compilation information for the system firmware: 

Copyright (c) 1985 - 1989 Sun Microsystems, Inc. 

All Rights Reserved - World Wide 

Compiled on 4/24/89 using hostname:/directory_path 
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2. New Boot-Up Features 


The Power-Up Display 


This section describes the type of display that appears on the console screen 
when you power-up, and the EEPROM entries required to change the first line of 
that display, or the presence/appearance of the Sun logo. 

An EEPROM option that ensures a boot from the Intelligent Peripheral Interface 
board is also described. 

A special EEPROM entry needed in order to perform a diagnostic boot on a Sun- 
3/80 is described. 

Finally, the new PROM monitor security feature is discussed. 

When you power-up your Sun system, a banner tells you what model you have, 
what Boot PROM revision is on your CPU board, how much main memory is 
installed, what your system serial number is, and what your Ethernet address is. 
Now, in addition to that information, your Host ID number is also displayed. 
Please note that, for SPARCsystems, your banner may say Sun SPARCstation 
rather than Sun Workstation. Here is an example of the new power-up display: 

r: : : : : ■■ ■ ■■-:-; . ,--- . -\ 

Sun Workstation, Model Sun-3/400 Series. 

ROM Rev 3.0 12MB memory installed. Serial #128. 
Ethernet address 1:2:30:4:55:66, Host ID 12345678. 
__ : : > 


Note that it is possible to change the Sun logo so that it appears three- 
dimensional, when a CG6 board is installed in your system. In addition, you 
may delete the first line of the banner shown above, and replace it with a banner 
and logo of your choice: 

- _ ---------TT---~ ---—-, \ 

SomeOtherCompany name 

custom ROM Rev 3.0 12MB memory installed. Serial #128. 
logo Ethernet address 1:2:30:4:55:66, Host ID 12345678. 

V - x £ : - ' : : - * j ,. ■. " 1 x: . : ' ^ ' -. '■■■' '■ ■ ■ ' '' ’ . ■ : . _ j, ' _ '''' :: • > 

In order to change the first line of the Sun power-up banner or replace the Sun 
logo, you must change EEPROM parameters. Chapter 14 of the PROM User’s 
Manual describes use of the PROM monitor program q command and provides 
the values and EEPROM offset addresses that must be changed in order to accom¬ 
plish this power-up display change. 

If you want to change the first line of the power-up display, you must enter the 
hexadecimal value 12 in the EEPROM location 020. Then you must enter 
replacement text in locations 068 through 0B7. You may use the new @ symbol 
before each character, instead of converting them to hexadecimal as described in 
the PROM User’s Manual. 

If your system has a CG6 board installed, you may enter the value 6 in location 
18F, and a special banner with a three-dimensional Sun logo will be displayed 
upon power-up. 

If you want to replace the Sun logo with another bit-mapped display, you must 
enter a 12 in EEPROM location 18F. If any other value is in location 18F, the 
Sun Logo will be displayed upon power-up. The replacement 64x8 bit-mapped 
display must be placed in EEPROM locations 290 through 48F. 


f#sun 
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To summarize the EEPROM locations that affect the power-up display: 


EEPROM 

Location 

Purpose 

020 

Choose type of banner 

0 = Standard Sun banner 

12 = Display banner stored in 068 - 0B8 

18F 

Choose type of Logo 

6 = Three dimensional Sun banner (requires CG6 board) 
12 = Display logo stored in locations 290 - 48F 
all other values = Display standard Sun logo 


Automatic IPI Boot-Up If you want to ensure that your system always boots from the Intelligent Peri¬ 

pheral Interface board, you may use the q command to change EEPROM location 
0x018 to the value 12, and then locations 0xl9-lD to contain the boot sequence 

id(0,0, 0) 

The SunOS eeprom command provides a simple, interactive way of making the 
same change. To do so, become super-user, then enter 

#eeprom 

You will now view some of the configuration information present in the 
EEPROM. To set the boot device, you must enter: 

#««prom default_boot=true (this means you want to specify the boot device) 

#aoprom bootdev="id (0, 0,0)" (boot only from IPI disk 0, controller 0, partition 0) 

To verify the change, enter the eeprom command again. You should now see 
these entries: 

default_boot=true 
bootdev=id(0,0,0) 


Sun-3/80 Diagnostic Boot-Up The Sun-3/80 has no diagnostic switch. If you want to attach a terminal to serial 

port A and view the diagnostic self-test messages, you must first use the PROM 
monitor q command to enter 12 in EEPROM location 0x70b. Any other value 
causes tests to run without error reporting to the terminal. 

PROM Monitor Security Chapter 10 of the PROM User’s Manual describes the Sun-3 and Sun-4 

Feature EEPROM. There is now a Security Mode Select Feature, located at EEPROM 

address 0x492. This feature provides a non-secure mode that permits the use of 
all PROM monitor commands. 

It also provides a command secure mode that permits the use of PROM monitor 
commands (other than c, for continue, or b, for boot, without parameters) only 
when a password is entered. In the command secure mode, you may operate 
your workstation normally, including powering down, booting, terminating with 
the LI-A command, and re-booting. You may not, however, perform any 
unusual operations, such as booting a non-standard kernel, running diagnostics. 
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The Password 


or changing EEPROM or CPU board memory contents, without entering a pass¬ 
word. 

Finally, this feature provides a fully secure mode that does not permit use of the 
PROM monitor (other than the c command with no parameters) without entering 
a password. To power-up, re-boot, or perform any other PROM monitor opera¬ 
tion, you must supply a password. This mode allows you to control access to the 
workstation by turning it off. The workstation does not automatically boot on 
power-up. 

CAUTION In fully secure mode, even a default boot cannot be completed unless the 
password is entered. Once the SunOS is halted, you cannot restore it until 
you enter the correct password after the prompt. If the password is unk¬ 
nown, the system CPU board must be serviced as a failed board. 

If you should attempt to enter a PROM monitor command such as q, for example, 
on a system that is set for one of the secure modes, your interaction might look 
like this: 


---- —• 

>q 020 

(you want to look at EEPROM offset address 020) 

>Mon Pass: : 

(you enter the correct password) 

>EEPROM 020: 00 ? 

(the conten ts of location 020 are shown) 

—-.. :: _ ^ 


Or, if you enter an incorrect password, your interaction might look like this: 

■■■■ .. ' . .. ;::: l ': - ' .., ! - 

>q 020 

>Mon Pass: (you enter the wrong password) 

>Invalid 

(there is a slight delay) 

> 


You may now try again or enter an unprotected command. 

To install or change a password, the system must be in non-secure mode, or you 
must know the existing password for a secure system. You then use the PROM 
monitor q command to enter the password in EEPROM offset location 490 


NOTE When you attempt to change the values stored in the EEPROM monitor password 
locations, you will be prompted with this message: 

Modifiying security location(s). Are you sure?(y/N) 

If you enter y for yes, the change you entered is written to the location shown. If 
you enter n for no, nothing is written to EEPROM, and the contents of the next 
location are displayed. 

To enter a monitor password, use the @ character, described at the beginning of 
this document, in order to enter the letters that make up the password. If you do 
not use the @ character, you must enter the hexadecimal equivalent of the letters. 
Following is an example of the way you would enter a password called 
mypasswd on a Sun-3 or SPARC -based system. You enter one letter per loca¬ 
tion, followed with : [ Return 1 . To exit the command, you may enter any non- 
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hexadecimal character, such as period, as showa 



NOTE If a password was already stored in locations 493-49a, hexadecimal values 

would appear in place of the zeroes in the example above. 

The password you enter must fill the eight bytes (locations 493-49a) with a char¬ 
acter or a zero. 

Note that changes to the security mode and password do not take effect until the 
PROM monitor mode is exited and then re-entered. 

It is recommended that the password is changed before the security mode is 
changed. For more information on using the EEPROM q command, refer to the 
PROM User’s Manual, SunPN 800-1736, or the Monitor (8S) section of the 
SunOS Reference Manual. 

Changing Security Modes The EEPROM offset location 492 contains a value that determines the security 

mode. The table below shows the interpretation of values found in that location. 
The “Ox” denotes a hexadecimal value. 

0x1 command secure 

0x5e fully secure 

all other values non-secure 

It is also recommended that the chmod and /etc/chown commands be used 
so that the /dev/eeprom device file may be accessed by the super-user. To 
accomplish this, enter: 



sun 

microsystems 


Revision A, of 13 June 1989 PN 800-1736-10 









6 



EEPROM Layout for PROM Here is a table that shows the EEPROM offset locations for the Sun-3 and SPARC 
Security -based systems. 


Sun-3 ARC 

Field 

Function 

Offset 



0x490-1 

bad_login 

The bad login 
counter stores the 
number of invalid 
password attempts. 
The maximum 
value is 65535 and 
the counter does not 
roll over to 0. 

0x492 

secure 

The values 1 and 

0x5e correspond to 
command secure 
and fully secure, 
respectively. Any 
other value is non- 



secure. 

0x493-a 

password 

If the password is 
shorter than 8 bytes, 
the password string 
is fenced with a null 
character. 
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3. Sun-3 Extended Tests Chapter 9 of the PROM User’s Manual describes Sun-3 extended tests. For 

workstations with the boot PROM version 2.8, many of these tests are unavail¬ 
able, and the user interface has changed. The new PROM version tests only the 
devices needed to boot the operating system. Therefore, when you invoke the 
extended tests from the monitor prompt, 



the menu of extended tests look something like this: 



NOTE For CPU boards with the AMD AM7990 (Lance) Ethernet chip, the first choice 
will be 

ae - AMD Ethernet Test 

New Boot Path Extended In order to invoke the disk and tape bootpath tests when a version 2.8 PROM is 

Tests installed on a Sun-3 CPU board, you must enter an asterisk after the boot com¬ 

mand, from the monitor prompt: 



The extended test appropriate for the named device will then be executed, and 
any error messages displayed on the screen, device could be one of the follow¬ 
ing: 

sd for SCSI disk 

st for SCSI tape 

id for IPI Controller 

xd for Xylogics 7053 Disk Controller 

xt for Xylogics tape 

xy for Xylogics 4501451 Disk Controller 


The Power-Up Test Sequence 


In order to perform the power-up tests, two assumptions must be met. The CPU 
(the non-PMMU portion of the MC68030 for the Sun-3/400 series system) must 
be functional and the ability to fetch instructions from the Boot PROM must be 
intact. 

Powering up a Sun-3 workstation resets the CPU to boot state, which means that 
all instruction fetches are forced to the Boot PROMs. Execution of the minimum- 
confidence power-up tests begin immediately. These tests do not employ any 
memory until memory has been successfully checked. 
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The objective of the power-up test sequence is to determine whether or not the 
CPU board logic and main memory are functional. Following the successful com¬ 
pletion of the power-up tests and subsequent workstation initialization, an 
attempt is made to boot the SunOS operating system, an EEPROM-specified pro¬ 
gram, or an operator-specified stand-alone program. 

If hardware problems are detected during the verification process, the PROM 
monitor prompt should appear. 

For Sun-3/400 series systems, if the Diagnostic Switch at the rear of the system is 
in NORM position, you will not be able to interact with the self-tests. You may 
read the LEDs on the CPU board edge (described later in this chapter) to deter¬ 
mine whether or not a test is failing, and you will see a rotating diagonal symbol 
after the 

Testing _ megabytes of memory... 

message on the console during the memory tests. The quantity of memory 
checked during a power-up with the diagnostic switch on NORM is dependent on 
EEPROM programming. The EEPROM chapter in the PROM User’s Manual and 
the eeprom command description in the SunOS Reference Manual explain how 
to set the parameter that controls the quantity of memory tested. 

For the Sun-3/80, which has no diagnostic switch, an EEPROM parameter must 
be set in order to execute a diagnostic boot-up and view the self-test display on a 
terminal. Refer to the “Diagnostic Power-Up” section for more information on 
this setting. 

If the workstation contains a large amount of main memory, self-tests may last as 
long as eight minutes. The table below compares the self-test duration of various 
Sun-3 systems. 
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Additional Change Pages and Addenda 
for the Docubox and Reference Manual 

Change Pages and Addenda to the Docubox (Part Number 800-3378) contains a 
set of manual pages updated for this release. This set is current except for 
setup_client(8), setup_exec(8), suninstall(8), and sunup- 
gr ade(8). The latest manual pages for these utilities are contained in this 
appendix, behind Table C-l. 


Note that Chapter 14 of the “System and Network Administration Addenda” 
contains numerous references to /usr/etc/ypinit, for example: 


f . .x.x : x ; : ; • . 

# /usr/etc/vpinit -s master 








\ 

£?iii 

V 







The ypinit program is not in the /usr/etc directory. The correct path is 


/usr/etc/yp/ypinit 
The following pages are affected: 

□ Page 106 (two screen displays) 

□ Page 107 

□ Page 115 (the second screen display) 


C.l. Reference Manual 
Change Summary 


Table C-l briefly summarizes the latest changes to the on-line versions of the 
SunOS manual pages. (Pages with minor editorial changes, fixed typographical 
errors, or format adjustments are not listed.) 
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Table C-1 Summary of Updated Online Manual Pages 


Manual Page 

Description of Correction or Change 

a.out(5) 

Corrects reference to r_index (was r_symbolnum). 

audit_warn(8) 

Reorganized and expanded (new sections include “OPTIONS” and 
“Auditing Conditions”). Removes the username argument. 

awk(l) 

Corrects the number of fields that can be input and addressed. 

boggletool(6) 

Corrects reference to /usr/games/boggletool (was 
/usr/games/chesstool). 

boot(8S) 

Corrects -b option description to reference /etc/rc. boot instead of 
/etc/rc.local. 

calendar(l) 

Notes that the default cront ab file no longer includes a call to calen¬ 
dar. 

cgtwo(4S) 

Now lists the correct interrupt level (4). 

clock(l) 

Reference to clocktool location changed to /usr/old. 

close(2) 

Notes that close() does not unmap the memory associated with a closed 
descriptor. 

conf ig(8) 

References to: 

/usr/include/sys/conf 
makefile.sun[23] 
devices.sun[23] 

Changed to: 

/usr/share/sys/sun[234]/conf 

/Makefile.src 

devices 

Expanded to include an example of multiple swap partitions. 

cpio(l) 

Now correctly states that multiple tape volumes are not supported. Also 
notes that the -r and -p options cannot be used together. 

cpp(l) 

Removes incorrect references to M68010, M68020, and m68k as 
predefined symbols. 
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Table C-1 Summary of Updated Online Manual Pages (cont’d. 

Manual Page 

Description of Correction or Change 

crontab(l) 

Added username argument. Corrected the following example: 

From 

0 0 1-5 * * /usr/local/weekdays 

0 0 0,6 * * /usr/local/weekends 

To 

0 0 * * 1-5 /usrAocal/weekdays 

0 0 * * 0,6 /usr/local/weekends 

csh(l) 

Added :e modifier to variable-substitution discussion. Removed 
discussion of 386i DOS environment variable. Corrected and clarified 
description of maximum argument-list size. 

drand4 8(3) 

Now refers to erand48, lrand48, nrand48, mrand48, jrand48, and 
srand48 as well as to drand48. 

ed(l) 

Qarifies explanation of how to use\l and repeated substrings. 

eeprom(8S) 

Expanded to discuss ttya_use_baud, ttyb_use_baud, ttyajbaud, and 
ttyb_baud. 

etherf ind(2) 

Added discussion of new option. 

execve(2) 

Corrected to note that the #! interpreter interface recognizes a 
maximum of 32 characters. 

export fs (2) 

Numerous references to directory changed to file or directory. 

f ind(l) 

Expanded to include “fast find” and procedure for building 
/usr/lib/find/codes. 

f inger(l) 

Removed reference to nonexistent /W option. 

fparel(8) 

Qarifies system support. 

f seek(3) 

Now states that, when passed an unopened file pointer, f seek dumps 
core instead of returning -1. Explains also that f seek rejects a 
negative file offset on regular files. 

f stab(5) 

Now mentions that the name of a swap file made with mkf ile(8) can be 
the first field of an f stab record. The “SEE ALSO” section is also 
expanded. 

ftpd(8C) 

Now explains how to set up an anonymous FTP account. 

get doma inname (2) 

Now correctly notes that MAXHOSTNAMELEN in 
<sys/paparm. h> is 64, not 255. 

get f audit flags(3) 

Adds a “DIAGNOSTICS” section. 

getgraent(3) 

Now notes that getgraent() and getgranam() fail if the calling process 
does not have a UID of root. Also added “FILES” section. 


f#sun 
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Table C-1 Summary of Updated Online Manual Pages (conf d.) 


Manual Page 

Description of Correction or Change 

get host ent(3N) 

Now notes that the addr argument to gethostbyaddr() is a pointer to the 
binary format address of length len, not a character string. 

getopt(3) 

Now discusses optind as a function instead of an int. 

getpwaent(3) 

Now notes that getpwaent() and getpwanam() fail if the calling process 
does not have a UID of root. A “FILES” section is added. 

getrlimit(2) 

No longer states that there are no stack-overflow signals. Added a 
description of SIGSEGV handling. 

getrusage(2) 

Now documents the value returned when a call fails. 

gets (3) 

Suggests that gets() not be used to read files that contain null characters. 

get servent(3N) 

Now states that port numbers are returned in network short-byte order. 

gf xtool(l) 

Corrects reference to graphics_demos (was gp_demos). 

gpconf ig(8) 

Adds discussion of -u option. 

gpone(4S) 

Now lists the correct interrupt level (4). 

groups(l) 

Now provides System-V file-creation syntax for setting group ID. 

icheck(8) 

Removes spurious references to “default file system.” 

ie(2) 

Now explains the error message ieO: giant packet. 

inetd(8C) 

Improves the discussion of “wait-status.” 

inst allboot (8S) 

Corrects installboot example to use the raw device (/dev/rxyOa 
instead of (/dev/xyOa). 

lockf(3) 

Corrects error code (EAGAIN instead of EACCESS). 

lpd(8) 

Description of minfree changes to note that minfree specifies a number 
of kilobytes, not a number of disk blocks. 

lpr(l) 

Now mentions that available filter options are site-specific. 

lprm(l) 

Now notes that only the supemser can remove print jobs submitted from 
another host. 

ls(l) 

Updates the discussion of the -1 option. 

lseek(3) 

Now states that lseek rejects a negative file offset on regular files. 

makedbm(8) 

Now documents the -1 and -s options. 

malloc(3) 

Now documents mallocmap(). Adds information that realloc meets the 
specified SVID and draft ANSI C standards. 

man(7) 

Now notes that some manual pages must be preprocessed by tbl when 
using nr o f f -man manpage. 
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Table C-1 Summary of Updated Online Manual Pages (cont’d.) 


Manual Page 

Description of Correction or Change 

mcp(4S) 

A new “BUGS” section documents a problem with pin 4. 

mkf ile(8) 

Now notes that swap files used as swap areas do not need to be 
NFS-mounted. 

mp(3X) 

Adds the mcmp() library function. 

mt(l) 

Now notes that mt returns an exit status of 1 if it cannot open the 
specified tape drive. 

mv(l) 

Now notes that write permission is required in order to relocate a 
directory within the hierarchy. Clarifies how mv sets times. 

named(8C) 

References to filenamed changed to named. 

ncheck(8) 

Removed erroneous reference to “default file systems.” 

netstat(8C) 

Removed the -h option, which does not apply to net stat. 

newf s(8) 

Now notes that in order to install the bootstrap programs for a root 
partition, you must run installboot(8S) after you run newf s. 

nit if(4M) 

Now supports ioctl() SIOCADDMULTI and SIOCDELMULTI requests. 

nm(l) 

Now documents shared library differences. 

old-set key s(l) 

Now notes that the ‘ ‘nosunview” option is valid on a Sun-4 keyboard 
when used with the Sun386i architecture. 

on(lC) 

Now notes that root cannot use on or rexed(8C) for remote execu¬ 
tion. 

on_exit(2) 

Removes the statement incorrectly limiting the number of termination 
handlers to 20. 

pac(8) 

Adds the -m option. 

perfmeter(l) 

Now references /etc/inetd. conf instead of /etc/servers. 

The “SEE ALSO” section is also updated. 

popen(3) 

Changes the term standard input in the statement “... the standard input 
of the process doing the topopen....” standard output. 

pr audit (8) 

Now notes that you can specify up to 100 audit files on the command 
line. 

printcap(5) 

Corrects the descriptions of “if” and “of” throughout. 

printf(3S) 

Explains how a bug in /libc/gen/common/gconvert. c causes 
% #. g not to print a decimal point. 

ps(l) 

Now notes that options must be specified by the first command 
argument. 
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Table C-l Summary of Updated Online Manual Pages (cont y d.) 


Manual Page 

Description of Correction or Change 

rasf ilter8tol(l) 

Notes that a printer must support an appropriate imaging model, such as 
PostScript, in order to print an image. 

rc(8) 

Adds an explanation of the /var/adm/messages file and notes that it 
is not removed after it is created. 

realpath(3) 

Rewritten to reflect changes in the way realpath handles relative 
pathnames. 

resolver(3) 

The statement 

tinclude <arpa.h/resolv.h> 
is changed to 

tinclude <resolv.h> 

rexd(8C) 

Now documents the -s option. 

rm(l) 

Now notes that rm returns false (1) if it cannot find the requested file. 

rmt(8C) 

Corrected to state that spaces are significant and that a line feed must 
separate the second argument from the first. 

route(8C) 

Adds the -n option. 

rpc(3) 

Now includes svcupd_bufcreate and clntupdjbufcreate. Also corrects 
the pmap_set( ) declaration. 

rshd(8C) 

Corrects the specification of the source port range. 

rup(3N) 

Notes that rup -1 hosttist does not work, although rup [ -option ] or 
rup [hosttist] are allowed. 

rwhod(8C) 

Corrects reference to program location (it is / u s r / e t c / i n. r wh o d, 
not /etc/rwhod). 

savecore(8) 

Corrects the description of minfree and adds -v option. 

scandir(3) 

Corrects command synopsis. 

screenblank(l) 

Explains that, outside of the suntools environment, screenblank 
depends on updates to /dev/console in order to determine whether 
the screen should be blanked. 

screendump(l) 

Notes that the printer must support an appropriate imaging model, such 
as PostScript, in order to print an image. 

semop(2) 

Now notes that semop( ) returns 0 if successful. 

shelltool(l) 

Corrects example. 

From: E [4; WIDTH;HEIGHTt resize frame to WIDTH and 

HEIGHT 

To: E[4/HEIGHT;WIDTHt resize frame to WIDTH and 

HEIGHT 
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Table C-1 Summary of Updated Online Manual Pages (conf d.) 


Manual Page 

Description of Correction or Change 

statf s(2) 

Documents the sys/types . h include file. 

stty(3C) 

Changes stty() in the statement “...while the stty() call is to gtty(). 

su(l) 

Clarifies that USER is changed to username if username is not root. 

sunview(l) 

References to /dev/bwtwo changed to /dev/bwtwoO. 

swapon(2) 

Now notes that arguments may specify files. In the “FILES” section, 
changed: /dev/[ru] [pk] ?b to /dev/sd?b. 

switcher(l) 

References to /dev/bwtwo changed to /dev/bwtwoO. 

termio(4) 

Corrects the definition of CRTSCTS. 

test(lV) 

Now states that test follows symbolic links except when the -h option 
is used. 

textedit(l) 

Now documents the -t flag for shift_lines and the capitalize options. 

tset(l) 

Documents the new terminal size feature 

unif def(l) 

Corrects references to -id and -iu options to -iD and -iU. 

varargs(3) 

Now notes that va_start() takes one argument. 

vgrind(l) 

Expands the discussion of using vgrind with the standard input option. 

A warning not to confuse vgrind and csh special characters is added. 

xy(4S) 

Clarifies the description of raw I/O. 

ypinit(8) 

Notes that if both 3.x and 4.x servers exist in the network, the 4.x server 
should be configured as the master. 

yppasswdd(8C) 

Expands the discussion of password files. 
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SETUPOJENT (8) 


MAINTENANCE COMMANDS 


SETUPCLIENT (8 ) 


NAME 

setup_client - create or remove an NFS client 
SYNOPSIS 

/usr/etc/install/script/setup_client op clientname ypjype swapsize rootpcuh swappath 
homepath execpath kvmpath arch 

DESCRIPTION 

setup_client adds an NFS client to a server, or removes one. It can only be run by the super-user. It is also 
used by suninstall(8). 

The op argument indicates which operation to perform, either add or remove, to indicate whether to add or 
remove a client clientname is the hostname of the client ypjype indicates the type of Yellow Pages 
server or service to provide to the client, if any; it can be one of master, slave, client or none, swapsize is 
the number of bytes reserved for client’s swap file, rootpath is the pathname of the parent directory in 
which various client root directories reside; rootpathlclientname is the pathname of the client’s root direc¬ 
tory. swappath is the pathname of parent directory in which various client swap files reside; 
swappath!clientname is the pathname of the client’s swap file, homepath is the pathname of the (parent) 
directory in which the various home directories are to reside; it is the pathname of the directory that the 
client is to mount as /home, execpath is the full pathname of the directory in which the executables for the 
application architecture specified by the arch argument. This is the directory that the client mounts as /usr. 
kvmpath is the full pathname of the directory in which the kernel-specific executables for the architecture 
specified by the arch argument reside. This is the directory that the client mounts as /usr/kvm. arch 
specifies the client’s application architecture (for instance, Sun4, Sun3x...). See arch(l) for further expla¬ 
nation of “application architecture” and examples of valid application architectures. setup_client with no 
arguments displays a usage message that includes the proper arch argument for each supported application 
architecture. 

USAGE 

Before you add or remove a client, you must first make sure that the Internet and Ethernet addresses for 
clientname are listed in the YP hosts database (if the server is running the YP), or in the server’s /etc/hosts 
and /etc/ethers databases, respectively (if otherwise). Then, run setup_client with the add or remove 
operation. When adding a client, you must then bootstrap that client machine. 

A server must support a client’s specific application architecture before it can mount that client. The exe¬ 
cutable directory for that client’s application architecture must be present on the server. If this directory is 
absent, an error results. 

setup_client updates the /etc/bootparams file. If the server is a YP master, it updates local YP database. It 
does not propagate the local update to other YP servers. To propagate the updates, use the following com¬ 
mands: 

example# cd /var/yp 
example# make 

If the server is running YP but is not a YP master, setup_client issues a warning to indicate that the data¬ 
base is out of date. 

When arch is given as Sun2, suninstall issues a reminder to run the /usr/etc/ndbootd daemon for booting 
Sun-2 systems. 

setup_client creates swappath!clientname with the size, (number of bytes) you specify. You can append 
one of K or k to indicate kilobytes, M or m to indicate megabytes, or B or b to indicate 512-byte blocks, to 
size. Otherwise, size is taken to indicate an exact byte count. 

suninstall updates the /etc/exports file to allow root access to each client’s root file system. It exports the 
client’s swap and dump partitions only to the client. 

Note: The system administrator should verify that the /etc/exports file contains correct information, and 
that file systems are exported to the correct users and groups. Refer to exportfs(8) for details on exporting 
file systems. 


SunOS 4.0.3 


Last change: 20 April 1989 


1761 




SETUP_CUENT(8) 


MAINTENANCE COMMANDS 


SETUPCLBENT (8 ) 


EXAMPLES 


This example shows how to add a Sun-4 system NFS client to a server. 

example# setup_client add frodo client 16M /export/root /export/swap /home \ 
/export/exec/sun4 /export/exec/kvm/sun4 sun4 


To remove this client, you would merely substitute remove for add in the above example. 


FILES 


/etc/hosts 

/etc/ethers 

/usr/etc/ndbootd 

/etc/bootparams 

/etc/exports 


hosts database 

database of hostnames and Ethernet addresses 
ND boot block server 
boot parameter database 
database of exported file systems 


SEE ALSO 

exportfs(8), setup_exec(8) suninstall(8) 

Installing the SunOS 
DIAGNOSTICS 

incorrect number of arguments 

Check number and order of the arguments. 

must be run as root (super-user). 

setup_client can only be used by root (super-user). 

invalid operation type “xc”. 

Valid operations are add and remove. 

ATTENTION: xxxxxxxx —> booLsun? not created. 

(Sun-3 systems only.) A symbolic link can not be created because the boot file does not exist. 

ATTENTION: muxctSUN? —> boot .sun? not created. 

(Other than Sun-3 systems.) A symbolic link can not be created because the boot file does not 
exist. 

ATTENTION: /usr/etc/ndbootd needs to be running on server before bringing up “ client ”. 

The Sun-2 system boot daemon must be running in order to bootstrap a Sun-2 system. 
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SETUPEXEC (8) 


MAINTENANCE COMMANDS 


SETUP_EXEC (8) 


NAME 

setu P_ exec “ install architecture-dependent executables on a heterogeneous file server 
SYNOPSIS 

/usr/etc/install/setup_exec arch execpath kvmpath [-o] 

DESCRIPTION 

setupexec installs architecture-dependent executables from either a local tape drive or a remote host It is 
used to convert a standalone system or homogeneous file server to a heterogeneous file server, setup exec 
is a forms-based utility that can be invoked directly, but it is also used by suninstall(8). It can only be 
invoked by the super-user. 

The arch argument specifies the application architecture to install (for instance, Sun4, Sun3x...). See 
arch(l) for further explanation of “application architecture” and examples of valid application architec¬ 
tures. When run with no arguments, setup_exec displays a usage line that includes the proper format of the 
arch argument for each supported application architecture, execpath is the full pathname of the directory 
in which to install the executables. When setup_exec is done, the execpath directory is ready to mount as 
/usr by the heterogeneous server’s NFS clients of the indicated arch, kvmpath is the full pathname of the 
directory in which to install the kernel-specific executables (libkvm, pstat(8), ps(l), etc.). When 
setup_exec is done, the kvmpath directory is ready to mount as /usr/kvm by the heterogeneous server’s 
NFS clients of the indicated arch. 

setup_exec also updates the /etc/exports file (see exportfs(8)) to export the executable directories it has 
installed. A system administrator should verify this file to make sure that the directory has been exported 
to the correct groups. 

OPTIONS 

-o Override the software duplication prevention mechanism. Allows the user to reload a software 
category that is already installed. 

EXAMPLE 

This example shows how to install a directory of executables for Sun-4 system clients, 
example# setup_exec sun4 /export/exec/sun4 /export/exec/kvm/sun4 

FILES 

/etc/hosts 
/etc/ethers 
/etc/exports 
/ usr/e tc/install/files 
/usr/etc/install/files/extractlist.arc/z 
/usr/etc/install/files/suninstall.log 
/usr/etc/install/save 
/usr/etc/intall/save/suninstall.log 

SEE ALSO 

exportfs(8), setup_client(8), suninstall(8) 

Installing the SunOS 
DIAGNOSTICS 

incorrect number of arguments 

Check the number and the order of arguments. 

invalid architecture type “ arch”. 

An unsupported value for arch was supplied. 

invalid tape drive type “drive”. 

Valid tape drive types are local and remote. 

invalid tape type “tape”. 


hosts database 

database of hostnames and Ethernet addresses 
database of exported file systems 

records of software installed/extracted after initial installation 
record of extracted categories for application architecture arch 
history of systems installed/extracted after initial installation 
records of the initial software installation 
record of the systems initially installed 
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SETUP_EXEC (8) 


MAINTENANCE COMMANDS 


SETUP_EXEC (8) 



Valid tape types are ar, st, mt, and xt. 
can’t reach tapehost “tapehosf 

The IP address of tapehost is not in the hosts database, that is, the hosts YP database if the Yellow 
Pages are running, or the /etc/hosts file otherwise. 

Load release tape n 

Mount the release tape specified on the screen and type RETURN to continue. 
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STICKY (8) 


MAINTENANCE COMMANDS 


STICKY (8) 


NAME 

sticky - persistent text and append-only directories 
DESCRIPTION 

The sticky bit (file mode bit 01000, see chmod(2)) is used to indicate special treatment for certain execut¬ 
able files and directories. 

Sticky Text Executable Files 

While the sticky bit is set on a sharable executable file, the text of that file will not be removed from 
system swap area. Thus the file does not have to be fetched from the file system upon each execution, 
long as a copy remains in the swap area, the original text cannot be overwritten in the file system, nor 
the file be deleted. Directory entries can be removed so long as one link remains. 

Sharable executable files are made by the -n and -z options of ld(l). 

To replace a sticky file that has been used: 

• Clear the sticky bit with chmod(lV). 

• Execute the old program to flush the swapped copy. This can be done safely even if others are 
using it. 

• Overwrite the sticky file. If the file is being executed by any process, writing will be prevented; it 
suffices to simply remove the file and then rewrite it, being careful to reset the owner and mode 
with chmod and chown(2). 

• Set the sticky bit once again, if still needed. 

Only the super-user can set the sticky bit on a sharable executable file. 

Sticky Directories 

A directory for which the sticky bit is set restricts deletion of files it contains. A file in a sticky directory 
may only be removed or renamed by a user who has write permission on the directory, and either owns the 
file, owns the directory, or is the super-user. This is useful for directories such as /tmp, which must be 
publicly writable, but should deny users permission to arbitrarily delete or rename the files of others. 

Any user may create a sticky directory. See chmod for details about modifying file modes. 

BUGS 

Since the text areas of sticky text executables are stashed in the swap area, abuse of the feature can cause a 
system to run out of swap. 

Neither open(2V) nor mkdir(2) will create a file with the sticky bit set 

FILES 

/tmp 

SEE ALSO 

chmod(lV), ld(l), chmod(2), chown(2), mkdir(2), open(2V) 
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SUNINSTALL ( 8) 


MAINTENANCE COMMANDS 


SUNINSTALL (8 ) 


NAME 

suninstall - install and upgrade the Sun Operating System 
SYNOPSIS 

/usr/etc/install/suninstall 

DESCRIPTION 

suninstall is a forms-based subsystem for installing and upgrading the Sun Operating System (Sun OS) on 
Sun-2, Sun-3 and Sun-4 systems. Unlike previous installation subsystems, suninstall does not require 
recapitulation of an interrupted procedure; you can pick up where you left off. A new invocation of sunin¬ 
stall displays the saved information and offers the user an opportunity to make any needed alterations 
before it proceeds. 

Note: suninstall should only be invoked from the miniroot (see Installing the SunOS 4.0.3). 

suninstall allows installation of the operating system onto any system configuration, be it standalone, data- 
less, a homogeneous file server, or a heterogeneous server. It installs the various versions of the operating 
system needed by clients on a heterogeneous file server, from any distribution tape format The number of 
different system versions that can be installed is only limited to the disk space available. 

Using setup_client(8) and setup_exec(8), a 4.0 standalone system can be converted into a 4.0 server 
without taking down or rebuilding the system. setup_client(8) adds or removes a diskless client while the 
server is running in multiuser mode; setup_exec(8) converts a 4.0 standalone system or server into a 
heterogeneous file server while it is running multiuser. 

To abort the installation procedure, use the interrupt character (typically CTRL-C). 

USAGE 

Refer to Installing the SunOS 4.0.3 for more information on the various menus and selections. 

FILES 

/usr/etc/install 
/usr/e tc/install/ files 
/usr/etc/install/get_*_info 
/usr/etc/install/installation 
/usr/etc/install/makedir 
/usr/etc/install/script 
/usr/etc/install/xdrtoc 

SEE ALSO 

extract_unbundled(8), setup_client(8), setup_exec(8) 

Installing the SunOS 4.03. 


directory containing installation programs, scripts and files 

directory containing default data files for clients and hosts 

terminal data-entry forms 

subsystem utility program 

subsystem utility program 

subsystem utility scripts 

subsystem utility program 
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SUNUPGRADE (8) 


MAINTENANCE COMMANDS 


SUNUPGRADE (8) 


NAME 

sunupgrade - upgrade the Sun Operating System 
SYNOPSIS 

/usr/etc/sunupgrade [ -1 ] [ -d ] [ -n ] 

AVAILABILITY 

This command is available on Sun2, Sun3 and Sun4 application architectures running SunOS version 4.0 or 
later only. Refer to Installing the SunOS 4.0.3 for more information. 

DESCRIPTION 

sunupgrade is an interactive utility used to upgrade the Sun Operating System (SunOS) to a higher revi¬ 
sion level on Sun2, Sun3, and Sun4 application architectures. The current SunOS level must be at least 
SunOS 4.0. 

Note: sunupgrade should only be invoked from the miniroot (see Installing the SunOS 4.0.3). 
sunupgrade lets you upgrade any system configuration. The following are the valid configuration types: 

• Standalone 

• Homogeneous server 

• Heterogeneous server 

• Dataless clients 

• Diskless clients 

Both local and remote installation modes are supported. 

sunupgrade overlays new executable administrative files on top of existing ones; the user must resolve the 
differences between the conflicting files after sunupgrade is completed. If new and old versions of these 
ASCII files are not identical, the newer file is installed with a trailing suffix reflecting the release name. The 
older versions of vmunix are saved with a trailing suffix indicating the pre-release version. Except for 
/usr/share/sys/sun/conf.c, these conflicts will only arise in the /etc and /var directories. 

All of these conflicting files are logged in /usr/etc/upgrade/save/special_files for servers and standalone 
systems, /usr/etc/upgrade/save/c/tenrnam£.special_files for diskless clients, and 
/home/upgrade/speciaI_files for dataless clients. 

Errors returned by sunupgrade during the upgrade procedure are saved in /usr/etc/upgrade/save/errlog. 

After sunupgrade completes execution: single-user mode must be invoked; all special files inspected; the 
older administrative files replaced with the newer ones and renamed without the suffixes; and errlog 
checked for errors. 

OPTIONS 

-1 Create log of all files extracted and overlaid. Performance will deteriorate slightly. Log files are 
saved in the directory /usr/etc/upgrade/save. A log called upgrade_files is created in that direc¬ 
tory containing the filenames of all the new files installed. Client log files are installed as 
clientname .upgrade_files. 

-d Work in debugging mode. Not recommended for normal operation. 

-n Switch off “no-rewind” operation. The no-rewind operation available only on systems running 
SunOS 4.0.2-CG8 or 4.0.3. 

FILES 

/usr/etc/upgrade/EXCLUDELIST 

/usr/etc/upgrade/README 

/usr/etc/upgrade/checksums 

/usr/etc/upgrade/chk_ok 

/usr/etc/upgrade/chk_release 

/usr/etc/upgrade/chkextract 

/usr/etc/upgrade/config_host 

/usr/etc/upgrade/extract 


SunOS 4.0.3 


Last change: 21 April 1989 


1770a 




SUNUPGRADE(8) 


MAINTENANCE COMMANDS 


SUNUPGRADE (8) 



/usr/etc/upgrade/extract_client 

/usr/etc/upgrade/extract_clntroot 

/usr/etc/upgrade/extract_stand 

/usr/etc/upgrade/include 

/usr/etc/upgrade/includefile 

/usr/etc/upgrade/get_arch 

/usr/etc/upgrade/get_clientinfo 

/usr/etc/upgrade/get_machtype 

/usr/etc/upgrade/get_tapeinfo 

/usr/etc/upgrade/get_toc 

/usr/etc/upgrade/get_upgradeinfo 

/usr/etc/upgrade/mop_up 

/usr/etc/upgrade/mount_ufs 

/usr/etc/upgrade/mount_usr 

/usr/etc/upgrade/start_log 

/usr/etc/upgrade/save/errlog 

/usr/etc/upgrade/save/special_files 

/usr/etc/upgrade/save/upgrade_files 

/usr/etc/upgrade/setup_kvm 

/usr/etc/upgrade/small_kernel_files 

/usr/etc/upgrade/sun2_cp_share 

/usr/etc/upgrade/sun2_ln_exec 

/ usr/etc/upgrade/sunupgrade 

/usr/etc/upgrade/tar_clntroot 

/usr/etc/upgrade/verify_clntpart 

/usr/etc/upgrade/xdrtoc 


SEE ALSO 



suninstall(8) 

Installing the SunOS 4.0.3 
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